Codescene MCP Server

官方

将 CodeScene 的代码健康分析作为本地 AI 友好的工具暴露给 MCP。

分类: 开发工具第 295 / 438
Stars: ★ 68 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · 预编译二进制
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 2 天前
工具数: 5

46FMRS · D

CodeScene MCP 服务器为 AI 助手提供了代码健康分析能力，强调本地运行和 AI 友好的工具设计。它适合将 AI 开发与代码质量提升结合的场景，但需要 CodeScene 账户支持。官方维护，文档详细，但存在模型依赖和配置复杂性风险。

最强项 · 文档质量 13/20 最弱项 · 维护活跃度 6/20

可靠性

7/20

安全与权限

8/20

维护活跃度

6/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: 仅能基于 README 与 manifest 审查：manifest 格式有效，声明 npm stdio 包与 npx 启动，README 给出工具使用场景，但未提供源代码、CI 或测试；server 版本 1.1.0 与 npm 包版本 0.3.1 不一致，错误处理和依赖失败行为无法验证。按静态校准，缺少可复现执行证据，不高于 12，且不确定性向下取分。
安全与权限 8/20: 未发现恶意代码、真实令牌泄露等红线；README 声明使用 CS_ACCESS_TOKEN 环境变量、分析在本地完成、只通过 REST 与自己的 CodeScene 实例通信，数据流说明较清楚。但未提供源码审计、最低权限/确认机制或网络边界实现的证据，无法核实声明，因此不能给满分。
维护活跃度 6/20: 仓库未归档，README 显示有 release、版本更新检查和多种发布渠道，看起来仍在维护；但 License 字段为 NOASSERTION，且没有提交频率、依赖更新、安全响应渠道等可验证证据，治理与许可证缺口导致扣分。
文档质量 13/20: README 覆盖安装、认证、用例、FAQ，并链接到 tools.md、configuration-options 等文档，分层较完整。但提供的证据中缺少实际工具参数、限制、成本、故障排除细节；文档链接本身只是声明，不能作为已验证证据，因此达不到满分。
安装易用性 12/20: README 给出 npx、Claude Code、Claude Desktop、VS Code、Homebrew、Windows、Docker 等多种安装方式，步骤看起来直接，认证用环境变量。但没有提供客户端 MCP JSON 配置示例，且首次运行下载二进制和缺少 CI/测试证据使安装可靠性和可复现性下降，按静态校准不超过 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要将 AI 驱动的开发与代码质量分析相结合的团队
希望利用 AI 助手安全重构遗留代码的开发人员
在 CI/CD 流程中集成代码健康检查的组织

不适合谁

没有 CodeScene 账户或独立许可证的用户（但可尝试独立版 Code Health MCP）
需要完全离线、无网络依赖的本地分析场景（但分析本身在本地，但获取热点等数据依赖 CodeScene 账户）
寻求代码分析功能全面替代 CodeScene 自身平台的用户

所需权限

需要 CS_ACCESS_TOKEN 以从 CodeScene 实例获取数据
本地代码库读取权限（用于分析）
在 Docker 安装时需要挂载卷以访问代码
可配置 SSL 证书环境变量（REQUESTS_CA_BUNDLE 等）
可设置 CS_DISABLE_VERSION_CHECK 以禁用版本检查

风险与副作用

传输风险：分析结果通过 REST 从自有 CodeScene 账户获取，但代码本身不会发送到外部；但需要确保 CodeScene 账户安全。
依赖风险：需要有效的访问令牌，令牌泄露可能导致数据暴露。
模型限制：较旧模型可能无法正确遵循 MCP 约束，影响重构质量。
路径幻觉：IntelliJ 的 AI 助手可能提供错误的 MCP 路径，导致连接失败。

安装接入

准备工作

运行环境：Node.js 18+ · 预编译二进制

CS_ACCESS_TOKEN 可选密钥 CodeScene 个人访问令牌，用于解锁 hotspots、技术债务目标等完整功能；在 CodeScene Cloud 或本地实例中创建。

其他可选配置项（4 个）

REQUESTS_CA_BUNDLE 可选指向内部 CA 证书文件（PEM 格式），用于自定义 SSL 证书配置。

SSL_CERT_FILE 可选 REQUESTS_CA_BUNDLE 的替代方式，同样指向 CA 证书文件。

CURL_CA_BUNDLE 可选另一种替代的 CA 证书文件环境变量。

CS_DISABLE_VERSION_CHECK 可选设为任意非空值（如 1）可禁用对 GitHub 新版本发布的后台检查。

获取访问令牌：在 CodeScene 实例中创建个人访问令牌（CS_ACCESS_TOKEN）。
选择安装方式：通过 npx (npx @codescene/codehealth-mcp)、全局 npm 安装、Homebrew (brew install cs-mcp)、Windows 脚本、手动下载或 Docker (docker pull codescene/codescene-mcp) 安装。
配置 AI 助手：将 MCP 服务器添加到你的 AI 助手（如 Claude Desktop、VS Code 等）中。
复制代理指导文件（AGENTS-full.md 或 AGENTS-standalone.md）到仓库，并根据需要添加技能。
验证工具是否可用。

验证是否装好

安装后在客户端工具列表中应出现 code_health_review、hotspots 等工具；也可以让 AI 对当前仓库执行一次 Code Health 审查，能返回评分即说明连接成功。

常见排障

检查 CS_ACCESS_TOKEN 是否设置且有效。
对于 Docker，确保挂载了正确的代码目录路径。
如果使用自定义 SSL 证书，设置 REQUESTS_CA_BUNDLE 指向 CA 证书文件。
如果 IntelliJ 给出错误路径，尝试手动指定正确的 MCP 服务器路径。
查看文档中的常见问题部分，如版本更新检查禁用等。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

对这个仓库运行一次 Code Health 审查，指出主要的可维护性问题。
列出当前代码库中的热点文件及其健康评分。
查看我们与既定技术债务目标的达成进度。
对比本次改动前后的 Code Health 分数，确认重构是否有效。

工具能力 5

code_health_review 只读

对指定代码段执行代码健康审查，识别设计问题。

hotspots 只读

获取热点代码区域列表，这些是变更频繁且复杂度高的代码区域。

technical_debt_goals 只读

检索技术债务目标，了解需要优先解决的技术债。

code_ownership 只读

查看代码所有权信息，了解各模块的负责人。

delta_review 只读

对代码变更进行增量审查，评估变更对代码健康的影响。

使用场景

保护 AI 生成的代码：防止 AI 引入技术债务，通过标记可维护性问题。

提升不健康代码的 AI 可读性：通过聚焦的代码健康审查和渐进式重构，改善代码模块化。

进行有目标的重构：利用代码健康工具确定修复方向，并用更新后的代码健康分数验证效果。

在行动前理解现有代码：使用代码健康审查提供基于真实认知和设计挑战的摘要和诊断。

支持客户端

Claude Desktop

VS Code

JetBrains IntelliJ部分支持

GitHub Copilot

Cursor

依据项目文档列出，未经本站实测。

详细介绍

CodeScene MCP 服务器将 CodeScene 的代码健康分析功能封装为本地 AI 友好工具，供 GitHub Copilot、Cursor、Claude Code 等 AI 助手使用。它可以对代码库进行代码健康洞察，包括可维护性问题、复杂性和技术债务等。服务器完全在本地运行，代码和分析不会发送到外部。需要 CodeScene 账户或独立许可证。