{"id":27021597,"url":"https://github.com/sapientpants/deepsource-mcp-server","last_synced_at":"2025-04-04T19:51:38.176Z","repository":{"id":284751556,"uuid":"955945548","full_name":"sapientpants/deepsource-mcp-server","owner":"sapientpants","description":"Model Context Protocol (MCP) server for DeepSource","archived":false,"fork":false,"pushed_at":"2025-04-04T06:53:03.000Z","size":166,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T07:33:52.538Z","etag":null,"topics":["deepsource","mcp","model-context-protocol","model-context-protocol-servers","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sapientpants.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-27T13:01:30.000Z","updated_at":"2025-04-04T06:51:38.000Z","dependencies_parsed_at":"2025-03-27T14:33:52.125Z","dependency_job_id":null,"html_url":"https://github.com/sapientpants/deepsource-mcp-server","commit_stats":null,"previous_names":["sapientpants/deepsource-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapientpants%2Fdeepsource-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapientpants%2Fdeepsource-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapientpants%2Fdeepsource-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapientpants%2Fdeepsource-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sapientpants","download_url":"https://codeload.github.com/sapientpants/deepsource-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247242591,"owners_count":20907128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deepsource","mcp","model-context-protocol","model-context-protocol-servers","typescript"],"created_at":"2025-04-04T19:51:37.715Z","updated_at":"2025-04-04T19:51:38.166Z","avatar_url":"https://github.com/sapientpants.png","language":"TypeScript","funding_links":[],"categories":["MCP 服务器精选列表","Developer Tools","🌐 Web Development","TypeScript"],"sub_categories":["🔒 安全与分析","How to Submit"],"readme":"# DeepSource MCP Server\n\n[![CI](https://github.com/sapientpants/deepsource-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/sapientpants/deepsource-mcp-server/actions/workflows/ci.yml)\n[![DeepSource](https://app.deepsource.com/gh/sapientpants/deepsource-mcp-server.svg/?label=code+coverage\u0026show_trend=true\u0026token=9XrIHVVGs9oZ-6fFSOPah2Ws)](https://app.deepsource.com/gh/sapientpants/deepsource-mcp-server/)\n[![DeepSource](https://app.deepsource.com/gh/sapientpants/deepsource-mcp-server.svg/?label=active+issues\u0026show_trend=true\u0026token=9XrIHVVGs9oZ-6fFSOPah2Ws)](https://app.deepsource.com/gh/sapientpants/deepsource-mcp-server/)\n[![DeepSource](https://app.deepsource.com/gh/sapientpants/deepsource-mcp-server.svg/?label=resolved+issues\u0026show_trend=true\u0026token=9XrIHVVGs9oZ-6fFSOPah2Ws)](https://app.deepsource.com/gh/sapientpants/deepsource-mcp-server/)\n[![npm version](https://img.shields.io/npm/v/deepsource-mcp-server.svg)](https://www.npmjs.com/package/deepsource-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/deepsource-mcp-server.svg)](https://www.npmjs.com/package/deepsource-mcp-server)\n[![License](https://img.shields.io/npm/l/deepsource-mcp-server.svg)](https://github.com/sapientpants/deepsource-mcp-server/blob/main/LICENSE)\n\nA Model Context Protocol (MCP) server that integrates with DeepSource to provide AI assistants with access to code quality metrics, issues, and analysis results.\n\n## Overview\n\nThe DeepSource MCP Server enables AI assistants to interact with DeepSource's code quality analysis capabilities through the Model Context Protocol. This integration allows AI assistants to:\n\n* Retrieve code metrics and analysis results\n* Access and filter issues\n* Check quality status\n* Analyze project quality over time\n\n## Features\n\n* **DeepSource API Integration**: Connects to DeepSource via REST API\n* **MCP Protocol Support**: Implements the Model Context Protocol for AI assistant integration\n* **TypeScript/Node.js**: Built with TypeScript for type safety and modern JavaScript features\n* **Cross-Platform**: Works on Linux, macOS, and Windows\n* **Robust Error Handling**: Comprehensive error handling for network, authentication, and parsing issues\n\n## Usage with Claude Desktop\n\n1. Edit `claude_desktop_config.json`:\n   - Open Claude Desktop\n   - Go to `Settings` -\u003e `Developer` -\u003e `Edit Config`\n   - Add the one of the configurations below to the `mcpServers` section\n\n2. Restart Claude Desktop to apply the changes\n\n### Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"deepsource\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"DEEPSOURCE_API_KEY\",\n        \"sapientpants/deepsource-mcp-server\"\n      ],\n      \"env\": {\n        \"DEEPSOURCE_API_KEY\": \"your-deepsource-api-key\"\n      }\n    }\n  }\n}\n```\n\n### NPX\n\n```json\n{\n  \"mcpServers\": {\n    \"deepsource\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"deepsource-mcp-server@1.0.0\"\n      ],\n      \"env\": {\n        \"DEEPSOURCE_API_KEY\": \"your-deepsource-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\nThe DeepSource MCP Server provides the following tools:\n\n1. `deepsource_projects`: List all available DeepSource projects\n   * Parameters:\n     * No required parameters\n\n2. `deepsource_project_issues`: Get issues from a DeepSource project\n   * Parameters:\n     * `projectKey` (required) - The unique identifier for the DeepSource project\n     * `offset` (optional) - Number of items to skip for pagination\n     * `first` (optional) - Number of items to return (defaults to 10)\n     * `after` (optional) - Cursor for forward pagination\n     * `before` (optional) - Cursor for backward pagination\n\n## Development\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/sapientpants/deepsource-mcp-server.git\ncd deepsource-mcp-server\n```\n\n2. Install dependencies:\n```bash\npnpm install\n```\n\n3. Build the project:\n```bash\npnpm run build\n```\n\n4. Configure Claude Desktop\n```json\n{\n  \"mcpServers\": {\n    \"deepsource\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/deepsource-mcp-server/dist/index.js\"\n      ],\n      \"env\": {\n        \"DEEPSOURCE_API_KEY\": \"your-deepsource-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Prerequisites\n\n* Node.js 20 or higher\n* pnpm 10.7.0 or higher\n* Docker (for container builds)\n\n### Scripts\n\n* `pnpm run build` - Build the TypeScript code\n* `pnpm run start` - Start the server\n* `pnpm run dev` - Start the server in development mode\n* `pnpm run test` - Run tests\n* `pnpm run lint` - Run ESLint\n* `pnpm run format` - Format code with Prettier\n\n## License\n\nMIT ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsapientpants%2Fdeepsource-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsapientpants%2Fdeepsource-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsapientpants%2Fdeepsource-mcp-server/lists"}