Codacy MCP 服务器

Codacy API 的 MCP 服务器，能够访问代码仓库、文件、质量、覆盖率、安全性等信息。

功能

工具

以下工具可以通过 Codacy MCP 服务器使用：

代码仓库管理

• codacy_list_repositories: 列出组织中的代码仓库，支持分页。

代码质量和分析

• codacy_list_repository_issues: 列出并筛选代码仓库中的代码质量问题。 这是调查一般代码质量问题（例如，最佳实践、性能、复杂性、风格）的主要工具，但不包括安全问题。 对于与安全相关的问题，请改用 SRM 项目工具。 功能包括：

  • 支持分页以处理大型结果集
  • 按多个标准进行过滤，包括严重性、类别和语言
  • 基于作者的过滤，以实现责任追究
  • 分支特定的分析
  • 基于模式的搜索

  常见用例：

  • 代码质量审计
  • 技术债务评估
  • 风格指南合规性检查
  • 性能问题调查
  • 复杂性分析

文件管理

• codacy_list_files: 列出代码仓库中的文件，支持分页。
• codacy_get_file_issues: 获取代码仓库中文件的 issue 列表。
• codacy_get_file_coverage: 获取代码仓库分支的 head commit 中文件的覆盖率信息。

安全分析

• codacy_list_srm_items: 列出安全项目/问题/漏洞/发现的主要工具。 结果与 Codacy 上的组织安全和风险管理 (SRM) 仪表板相关。 提供全面的安全分析，包括：

  • SAST（代码扫描）
  • Secrets（密钥扫描）
  • SCA（依赖项扫描）
  • IaC（基础设施即代码扫描）
  • CICD（CI/CD 扫描）
  • DAST（动态应用程序安全测试）
  • PenTesting（渗透测试）

  在调查安全或合规性问题时，请首先使用此工具。

Pull Request 分析

• codacy_list_repository_pull_requests: 列出用户有权访问的代码仓库中的 pull request。 您可以搜索此端点以查找上次更新（默认）、影响或合并的 pull request。
• codacy_list_pull_request_issues: 返回在 pull request 中发现的 issue 列表。 我们可以请求新的或已修复的 issue。
• codacy_get_repository_pull_request_files_coverage: 获取 pull request 中所有文件的覆盖率信息。
• codacy_get_pull_request_git_diff: 返回 pull request 的人类可读的 Git diff。

CLI 分析

• codacy_cli_analyze: 使用 Codacy 的命令行工具来分析代码。

设置

个人 API 访问令牌

从您的 Codacy 帐户 获取您的 Codacy 帐户 API 令牌。

用法

根据您将 MCP 服务器连接到什么，您可以使用以下方法：

• Cursor: 编辑 .cursor/mcp.json 文件以添加以下内容
• Windsurf: 编辑 .codeium/windsurf/mcp_config.json 文件以添加以下内容
• Claude Desktop: 编辑 claude_desktop_config.json 文件以添加以下内容

NPX

{
  "mcpServers": {
    "codacy": {
      "command": "npx",
      "args": ["-y", "@codacy/codacy-mcp"],
      "env": {
        "CODACY_ACCOUNT_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

VSCode with Copilot

要将 MCP 服务器连接到 VS Code 中的 Copilot，请将以下内容添加到 IDE 的全局配置中：

{
    "mcp": {
        "inputs": [],
        "servers": {
            "codacy": {
                "command": "npx",
                "args": [
                  "-y",
                  "@codacy/codacy-mcp"
                ],
                "env": {
                  "CODACY_ACCOUNT_TOKEN": "<YOUR_TOKEN>"
                }
              }
        }
    }
}

您可以在以下位置找到全局 settings.json 文件，具体取决于您的操作系统：

• for macOS: ~/Library/Application Support/Code/User/settings.json
• for Windows: %APPDATA%\Code\User\settings.json
• for Linux: ~/.config/Code/User/settings.json

确保已启用 Agent 模式：vscode://settings/chat.agent.enabled

Node (when using NVM)

当将 NVM 与 Claude Desktop 一起使用时，NPX 将不起作用。 您应该首先全局安装 MCP 服务器，然后直接使用 Node：

npm install -g @codacy/codacy-mcp

{
  "mcpServers": {
    "codacy": {
      "command": "/Users/yourusername/.nvm/versions/node/vXX.X.X/bin/node",
      "args": ["/path-to/codacy-mcp/dist/index.js"],
      "env": {
        "CODACY_ACCOUNT_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

构建

本地：

npm install
npm run update-api
npm run build

Codacy-CLI 支持 (WIP)

为了使用 Codacy-CLI，需要安装它。

许可证

此 MCP 服务器是在 MIT 许可证下授权的。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。