mcpField
C
Codescene

Codescene

本地服务
github.com/codescene-oss开发工具73今天更新
代码仓库

关于 Codescene

CodeScene MCP Server 在本地运行，将 CodeScene 的 Code Health 分析以工具形式提供给 AI 助手。它面向希望在编码过程中控制代码质量与技术债的开发者和团队，并附带可复用的公开 Agent 技能。

主要功能

  1. 01本地运行的 Code Health 分析工具
  2. 02标记复杂度、嵌套过深等可维护性问题
  3. 03提供可量化的 Code Health 前后对比
  4. 04附带公开 Agent 技能与指南文件
  5. 05支持 CodeScene Cloud 与本地部署

适用场景

  1. 01检查 AI 生成代码是否引入技术债
  2. 02按设计问题逐步重构遗留代码
  3. 03验证重构后 Code Health 评分是否提升

MCP 相关

该项目是 MCP 服务，向 Claude Code、Cursor、GitHub Copilot 等 MCP 客户端暴露 Code Health 分析工具。

#codescene#code-health#ai-tools

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codescene": {
      "command": "npx",
      "args": [
        "-y",
        "@codescene/codehealth-mcp"
      ]
    }
  }
}
启动命令npx -y @codescene/codehealth-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codescene/codehealth-mcp0.3.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

CodeScene MCP Server

CodeScene Hotspot Code Health CodeScene Average Code Health CodeScene System Mastery

CodeScene MCP Server 将 CodeScene 的 Code Health 分析作为适用于本地 AI 的工具提供。

此服务专为在本地环境中运行而设计，可让 AI 助手（如 GitHub Copilot、Cursor、Claude code 等）直接从你的代码库中获取有意义的 Code Health 洞察。 Code Health 洞察会为 AI 提示词补充丰富内容，涵盖代码质量问题、可维护性问题以及一般技术债务。

此代码库还提供一组可下载的公共 Agent 技能，位于 skills/，供希望在自己的 Agent 流水线中复用 CodeScene MCP 工作流的团队使用。

开始使用 CodeScene MCP

想让 AI 执行设置？请从 skills/installing-and-activating-codescene-mcp/SKILL.md 开始。

  1. 设置 MCP 服务的身份验证——请参阅身份验证。
  2. 使用下方的一种安装选项安装 MCP 服务。
  3. 将 MCP 服务添加到你的 AI 助手。请在安装指南中查看适用于你环境的详细说明。
  4. 将与你的许可证相匹配的 Agent 指引复制到你的代码库中：CodeScene Core 用户使用 AGENTS-full.md，独立许可证用户使用 AGENTS-standalone.md，Amazon Q 用户使用 .amazonq/rules。同时复制任何相关的公共 skills，以复用工作流提示词。
  5. 查看可用工具，了解 MCP 服务的功能以及你的许可证可使用哪些工具。

安装

选择最适合你平台的安装方式。

NPM / npx（macOS、Linux、Windows）

使用 npx 直接运行 MCP 服务（无需安装）：

npx @codescene/codehealth-mcp

也可以全局安装：

npm install -g @codescene/codehealth-mcp

首次运行时会自动下载适用于你系统的平台二进制文件，并缓存以供以后使用。需要 Node.js 18 或更高版本。

📖 完整安装与集成指南

Claude Code

添加 CodeScene 市场并安装插件：

/plugin marketplace add codescene-oss/codescene-mcp-server
/plugin install codescene@codescene

此操作会安装 MCP 服务和 Code Health 技能。需要 Node.js 18 或更高版本。

Claude Desktop

从最新发布页面下载 MCP 捆绑包：

  • codehealth-mcp-{version}.mcpb

然后使用 Claude Desktop 打开 .mcpb 文件，以安装 MCP 服务。

VS Code

CodeScene MCP 可作为 VS Code 扩展使用：

Homebrew（macOS / Linux） 
brew tap codescene-oss/codescene-mcp-server https://github.com/codescene-oss/codescene-mcp-server
brew trust codescene-oss/codescene-mcp-server
brew install cs-mcp

📖 完整安装与集成指南

Windows

对于 VS Code / GitHub Copilot，CodeScene MCP 扩展会打包并自动配置服务，无需单独通过 PowerShell 安装。

在 PowerShell 中运行以下命令：

irm https://raw.githubusercontent.com/codescene-oss/codescene-mcp-server/main/install.ps1 | iex

安装后，请完全退出并重新打开 AI 助手或 IDE（包括所有 VS Code 窗口），使其加载更新后的 PATH，然后按照下方指南配置 MCP 服务。仅重启 MCP 服务或集成终端不会刷新 VS Code 的 PATH。指南还包含一种直接使用可执行文件路径的 VS Code 配置方式，可避免此 PATH 要求。

📖 完整安装与集成指南

手动下载

从 GitHub Releases 页面下载适用于你平台的最新二进制文件：

  • macOS： cs-mcp-macos-aarch64.zip（Apple Silicon）或 cs-mcp-macos-amd64（Intel）
  • Linux： cs-mcp-linux-aarch64.zip 或 cs-mcp-linux-amd64
  • Windows： cs-mcp-windows-amd64.exe

下载后，将其设为可执行文件，并可选择将其添加到 PATH：

chmod +x cs-mcp-*
mv cs-mcp-* /usr/local/bin/cs-mcp

你也可以从源代码构建静态可执行文件。

Docker

警告

Docker 发行版即将停止维护。2026 年 10 月 1 日至 12 月 31 日期间，Docker 镜像仅会发布错误修复版本。2026 年 12 月 31 日之后将不再发布 Docker 镜像。请迁移至 NPM / npx、Homebrew、Windows 安装程序或上述其他安装方式。

docker pull codescene/codescene-mcp

📖 完整安装与集成指南 | 在本地构建 Docker 镜像

用例

提示

观看 CodeScene MCP 演示视频。

说明

CodeScene MCP 附带一组示例提示词、用于记录关键用例的 Agent 指引文件，以及一组可下载的公开技能。根据你的许可证，将相应的 Agent 指引文件——CodeScene Core 用户使用 AGENTS-full.md，独立版用户使用 AGENTS-standalone.md——以及任何相关技能复制到你自己的代码仓库中。

部署 CodeScene MCP 服务后，你的 AI 工具可以：

守护 AI 生成的代码

通过标记复杂度过高、嵌套过深、内聚性低等可维护性问题，防止 AI 引入技术债务。

改善不健康代码，为 AI 做好准备

当代码模块化且易于理解时，AI 重构的质量会更高。MCP 服务会为你的助手提供具体指导，帮助实现这一目标：

  • 执行有针对性的 Code Health 审查，
  • 找出需要解决的具体设计问题，
  • 以小步、可衡量的方式进行重构，以及
  • 通过更新后的 Code Health 评分验证进展。

仅使用 MCP 即可完成此工作流，而且通常足以安全地改进遗留代码。

有针对性地重构

AI 工具可以重构代码，但不知道该修复什么，也不知道如何衡量是否有所改善。
Code Health 工具通过向 AI 助手提供有关设计问题的精准洞察，以及客观评估结果的方式，解决了这个问题：Code Health 是否有所改善？

采取行动前了解现有代码

使用 Code Health 审查来指导 AI 驱动的摘要、诊断或代码转换，依据的是现实中的认知与设计挑战，而不只是语法。

检查 MCP 防护效果

让你的 AI 助手展示 MCP 使用概览，以查看 Code Health 的提升、避免的退化，以及最近 250 个 MCP 事件的范围和质量。受支持的客户端会显示交互式仪表板；其他客户端则会收到 Markdown 摘要。此 API 连接功能需要 CodeScene Core 账户，独立许可证无法使用。详情请参阅 show_mcp_usage_overview。

常见问题

使用 MCP 需要 CodeScene 账号吗？

完整功能集（包括热点、技术债务目标和代码所有权）需要 CodeScene 订阅。请让 AI 助手登录 CodeScene 进行身份验证，或使用登录工具。也可以使用你的 CodeScene 实例创建 CS_ACCESS_TOKEN，以启用 MCP。 MCP 同时支持 CodeScene Cloud 和本地部署的 CodeScene。

如果没有 CodeScene 订阅，但需要在本地进行 Code Health 分析，可以使用独立的 CodeScene Code Health MCP。

MCP 服务如何确保我的代码私密且安全？

CodeScene MCP 服务完全在本地运行。所有分析（包括 Code Health 评分、增量审查和商业案例计算）都在你的设备上针对本地代码仓库执行。 不会向云服务提供商、大模型供应商或任何外部服务发送源代码或分析数据。

分析结果（例如热点和技术债务目标）会通过 REST 使用安全令牌从你自己的 CodeScene 账号获取。

详情请参阅 CodeScene 完整的隐私和安全文档。

CodeScene MCP 可以使用任何大模型作为底层模型吗？

CodeScene MCP 可以使用 AI 助手支持的任何模型，但如果助手提供模型选择器（例如 GitHub Copilot 等工具），我们强烈建议选择前沿模型。

前沿模型（例如 Claude Sonnet）在遵循规则和重构质量方面表现出色，而 GPT-4.1 等旧版模型往往难以满足 MCP 的约束。 要获得稳定的高质量体验，请选择最新的可用模型。

我有多个代码仓库，如何配置 MCP？

由于需要为 Docker 提供挂载路径，你可以为每个项目分别配置 MCP（例如，在 VS Code 中为每个项目创建一个 .vscode/mcp.json 文件），也可以挂载一个包含所有项目的根目录，然后只使用这一份配置。

为什么 IntelliJ 提供给 MCP 服务的路径不正确？

在测试中，我们发现 IntelliJ 的 AI 助手有时会提供错误的 CodeScene MCP 服务路径。 据我们所知，这似乎与 MCP 服务本身无关，而是 IntelliJ 的 AI 助手有时会产生路径片段的幻觉。我们仍在调查此问题，获得更多信息后会更新本节。

如何配置自定义 SSL 证书？

如果你的组织使用内部 CA（证书颁发机构），请将 REQUESTS_CA_BUNDLE 环境变量设为你的 CA 证书文件（PEM 格式）的路径。MCP 服务会自动配置 SSL，只需设置一次即可。

MCP 也支持使用 SSL_CERT_FILE 和 CURL_CA_BUNDLE 作为替代项。

如需查看详细配置示例（包括 Docker 证书挂载），请参阅配置选项 — SSL/TLS。

如何禁用版本更新检查？

MCP 服务会定期检查 GitHub 是否有更新版本，并在你的版本过时时显示“VERSION UPDATE AVAILABLE”横幅。此检查在后台运行，不会阻塞工具响应，但在网络受限的环境中，你可能希望完全禁用它。

将 CS_DISABLE_VERSION_CHECK 环境变量设为任意非空值（例如 1）。有关设置详情，请参阅配置选项 — 版本检查。

## 从源代码构建

MCP 服务使用 Rust 编写。要从源代码构建：

cargo build --release

生成的二进制文件位于 target/release/cs-mcp。

更多详情，请参阅：

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。