DeepSource MCP 服务器

一个模型上下文协议 (MCP) 服务器，与 DeepSource 集成，为 AI 助手提供对代码质量指标、问题和分析结果的访问。

概述

DeepSource MCP 服务器使 AI 助手能够通过模型上下文协议与 DeepSource 的代码质量分析功能进行交互。这种集成允许 AI 助手：

• 检索代码指标和分析结果
• 访问和筛选问题
• 检查质量状态
• 随时间分析项目质量

特性

• DeepSource API 集成：通过 GraphQL API 连接到 DeepSource
• MCP 协议支持：实现模型上下文协议以进行 AI 助手集成
• TypeScript/Node.js：使用 TypeScript 构建，以实现类型安全和现代 JavaScript 功能
• 跨平台：可在 Linux、macOS 和 Windows 上运行
• 强大的错误处理：全面的错误处理，用于网络、身份验证和解析问题

与 Claude Desktop 一起使用

1. 编辑 claude_desktop_config.json：

   • 打开 Claude Desktop
   • 转到 Settings -> Developer -> Edit Config
   • 将以下配置之一添加到 mcpServers 部分

2. 重新启动 Claude Desktop 以应用更改

Docker

{
  "mcpServers": {
    "deepsource": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DEEPSOURCE_API_KEY",
        "sapientpants/deepsource-mcp-server"
      ],
      "env": {
        "DEEPSOURCE_API_KEY": "your-deepsource-api-key"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "deepsource": {
      "command": "npx",
      "args": [
        "-y",
        "deepsource-mcp-server@1.0.2"
      ],
      "env": {
        "DEEPSOURCE_API_KEY": "your-deepsource-api-key"
      }
    }
  }
}

可用工具

DeepSource MCP 服务器提供以下工具：

1. deepsource_projects：列出所有可用的 DeepSource 项目

   • 参数：
     • 无必需参数

2. deepsource_project_issues：从 DeepSource 项目获取问题

   • 参数：
     • projectKey（必需）- DeepSource 项目的唯一标识符
     • offset（可选）- 要跳过的项目数，用于分页
     • first（可选）- 要返回的项目数（默认为 10）
     • after（可选）- 用于向前分页的游标
     • before（可选）- 用于向后分页的游标

开发

1. 克隆存储库：

git clone https://github.com/sapientpants/deepsource-mcp-server.git
cd deepsource-mcp-server

2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm run build

4. 配置 Claude Desktop

{
  "mcpServers": {
    "deepsource": {
      "command": "node",
      "args": [
        "/path/to/deepsource-mcp-server/dist/index.js"
      ],
      "env": {
        "DEEPSOURCE_API_KEY": "your-deepsource-api-key"
      }
    }
  }
}

先决条件

• Node.js 20 或更高版本
• pnpm 10.7.0 或更高版本
• Docker（用于容器构建）

脚本

• pnpm run build - 构建 TypeScript 代码
• pnpm run start - 启动服务器
• pnpm run dev - 在开发模式下启动服务器
• pnpm run test - 运行测试
• pnpm run lint - 运行 ESLint
• pnpm run format - 使用 Prettier 格式化代码

许可证

MIT