
CodeHealth MCP Server by CodeScene
CodeScene 的 CodeHealth™ MCP 伺服器是一個本地 MCP 服務,它向任何 AI 編碼助手公開確定性的 CodeHealth 指標,持續評估 AI 生成的變更並驅動自我糾正的重構循環,以防止技術債務並保持程式碼可維護性。
https://codescene.com/product/mcp-server?ref=producthunt&utm_source=aipure

產品資訊
更新時間:2026年05月19日
什麼是 CodeHealth MCP Server by CodeScene
CodeScene 的 CodeHealth™ MCP 伺服器是一個模型上下文協定 (MCP) 伺服器,可讓 AI 編碼助手(例如 GitHub Copilot、Cursor、Windsurf、Claude Code 和其他 MCP 相容工具)直接從您的本地儲存庫查詢 CodeScene 的 CodeHealth 分析。它旨在透過將建議和重構建立在客觀的可維護性和變更風險訊號(例如結構複雜性和其他程式碼健康因素)上,使 AI 輔助編碼更安全、更可靠。該伺服器在您的控制下本地運行,旨在協助團隊保護 AI 輸出、提升舊有程式碼,並使用 CodeHealth 作為客觀品質門來標準化可維護性預期。
CodeHealth MCP Server by CodeScene 的主要功能
CodeHealth™ MCP Server by CodeScene 是一個本地模型上下文協議 (MCP) 服務,它將 CodeScene 的 CodeHealth 可維護性和變更風險分析公開為 AI 友善工具,因此編碼助手 (Copilot、Cursor、Claude Code 等) 可以檢測結構問題,朝著客觀閾值進行重構 (目標是達到 AI 就緒的 Code Health 約 9.5–10),並避免引入技術債務。它支援一種自我修正的工作流程,其中程式碼變更會不斷重新評估,並透過結構化回饋引導 AI 提高可維護性,而不僅僅是讓測試通過,同時將分析和原始碼保留在開發人員的機器上。
用於 CodeHealth 分析的本地 MCP 伺服器: 完全在您的本地環境中運行,並透過 MCP 工具公開 CodeScene 的 CodeHealth 見解,使助手和代理程式能夠直接從儲存庫查詢可維護性和風險訊號,而無需將原始碼發送到外部 LLM 供應商。
確定性 CodeHealth™ 品質門: 使用客觀的 CodeHealth 指標 (1-10 分) 和檔案級審查來識別具體的可維護性問題 (例如,複雜性、深度巢狀、低內聚性),並強制執行適用於 AI 輔助工作的閾值。
自我修正的重構循環: 當 AI 提出變更時,伺服器會重新檢查 CodeHealth,並在風險增加時返回結構化指導,推動代理程式迭代,直到達到可維護性目標。
AI 就緒的舊版升級工作流程: 支援使用 code_health_review 等工具的審查 → 規劃 → 重構 → 重新測量方法,幫助團隊在嘗試更大的代理功能工作之前模組化和改進不健康的舊程式碼。
透過 AGENTS.md 進行代理程式指導: 提供一種機制來編碼代理程式應如何使用 MCP 工具 (例如,提早運行審查、在提交/PR 之前進行保護、迴歸循環),以便團隊獲得一致、可重複的 AI 工作流程,而不是臨時的工具使用。
廣泛的助手/IDE 和語言相容性: 模型不可知且專為代理工作流程設計;透過 MCP 與許多 AI 助手/IDE 整合,並透過 CodeScene 分析支援 30 多種程式語言。
CodeHealth MCP Server by CodeScene 的使用案例
AI 輔助編碼與可維護性保障: 使用 Copilot/Cursor/Claude Code 的團隊可以根據 CodeHealth 訊號自動檢查 AI 生成的差異,並在可維護性下降時要求重構循環,從而減少 AI 引起的技術債務的可能性。
在功能自動化之前將舊系統現代化: 工程組織可以識別大型、不健康的檔案/函數,並使用引導式重構步驟來改善模組化和可讀性,擴大代理程式可以安全實施功能的「AI 就緒表面」。
受監管行業的拉取請求品質門: 在金融/醫療保健/企業環境中,團隊可以使用預提交和面向 PR 的保障措施來強制執行可維護性標準,作為審查和合規流程的一部分,從而提高程式碼品質決策的可審計性。
在高吞吐量產品團隊中擴展開發人員生產力: 快速變化的 SaaS/電子商務組織可以透過要求在開發過程中進行 CodeHealth 檢查來標準化 AI 使用,從而減少審查負擔並提高對 AI 輔助變更的信心。
工程領導的重構投資報酬率和優先順序: 領導者可以使用與 CodeHealth 相關的業務影響/投資報酬率計算來優先處理重構工作,並透過將可維護性改進與速度、缺陷風險和維護成本結果聯繫起來,證明投資的合理性。
優點
在您的控制下本地運行;無需將原始碼或分析數據發送到雲端供應商/LLM 供應商。
客觀、可重複的可維護性回饋 (CodeHealth) 實現了確定性重構循環,而不是主觀的「乾淨程式碼」建議。
模型不可知的 MCP 整合適用於多個助手/IDE,並支援多語言程式碼庫。
缺點
需要設定和配置 (令牌、MCP 客戶端整合、可選的內部部署 URL/SSL 設定),這可能會增加初始摩擦。
當團隊採用嚴格的工作流程 (例如,AGENTS.md 規則和重複檢查) 時最有效;如果忽略保障措施,效益可能會受到限制。
某些高級自動化 (例如,用於非常大函數的 ACE 輔助重組) 是可選的,可能需要額外的許可證。
如何使用 CodeHealth MCP Server by CodeScene
1) 取得 CodeScene 存取權杖: 為 CodeHealth MCP 伺服器建立或取得 CS_ACCESS_TOKEN。此權杖允許本地 MCP 伺服器存取 CodeScene 的 CodeHealth 分析。
2) 選擇安裝方法 (npx / global npm / Homebrew): 選擇其中一種:(a) 不安裝即可運行:`npx @codescene/codehealth-mcp`(首次運行會下載並快取正確的平台二進位檔)。(b) 全域安裝:`npm install -g @codescene/codehealth-mcp`。(c) 透過 Homebrew 在 macOS/Linux 上安裝:`brew tap codescene-oss/codescene-mcp-server https://github.com/codescene-oss/codescene-mcp-server`,然後 `brew install cs-mcp`。
3) 確保伺服器命令可用: 驗證您可以為您選擇的方法啟動 MCP 伺服器命令(例如,`npx @codescene/codehealth-mcp` 或 `cs-mcp`)。首次運行可能會下載特定平台的二進位檔並快取以供將來使用。
4) 在您的 AI 助手 (MCP 客戶端) 中註冊 MCP 伺服器: 在您的助手的 MCP 配置中新增一個 MCP 伺服器條目,以便它可以透過 stdio 啟動伺服器。典型的配置使用 `command: npx` 和 `args: ["@codescene/codehealth-mcp"]`(如果透過 Homebrew/全域安裝,則為 `command: cs-mcp`)。
5) 提供所需的環境變數(至少 CS_ACCESS_TOKEN): 在 MCP 伺服器配置(或您的環境)中設定 `CS_ACCESS_TOKEN`。MCP 客戶端提供的環境變數優先於任何伺服器端配置檔。
6) (可選) 配置 CodeScene 內部部署 URL: 如果您使用內部部署 CodeScene 實例,請在 MCP 伺服器環境中設定 `CS_ONPREM_URL`(例如,`https://codescene.mycompany.com`)。
7) (可選) 配置自訂 TLS/CA 憑證: 如果您的內部部署實例使用內部 CA,請將 `REQUESTS_CA_BUNDLE` 設定為您的內部 CA 憑證檔案的路徑,以便 MCP 伺服器可以驗證 TLS 連線。
8) 將代理程式指南新增到您的儲存庫(推薦): 將與您的授權相符的代理程式指南檔案複製到您的儲存庫中,以便 AI 代理程式遵循預期的工作流程和保護措施:`AGENTS-full.md` 用於 CodeScene Core 用戶,`AGENTS-standalone.md` 用於獨立授權用戶,或 `.amazonq/rules` 用於 Amazon Q。
9) 透過您的助手開始使用 CodeHealth 工具: 在您的 AI 助手中,呼叫 CodeScene MCP 工具以將變更建立在 CodeHealth 訊號中。如有疑問,請呼叫適當的 CodeScene MCP 工具而不是猜測,並儘早選擇正確的 CodeScene 專案(例如,透過 `select_codescene_project`)。
10) 在進行變更之前運行程式碼健康狀況審查: 使用 MCP 工具(例如,`code_health_review`)評估當前的可維護性並識別具體問題(複雜性、深度巢狀、低內聚性)。使用分數作為可衡量的目標(AI 就緒程式碼的目標為 9.5-10)。
11) 小步重構並重新測量: 遵循一個循環:審查 → 規劃 → 重構 → 重新測量。每次變更後,重新運行 CodeHealth 審查以確認可維護性提高且風險未增加。
12) 在提交或開啟 PR 之前使用保護措施: 在提交之前,運行 MCP 保護工具(例如,`pre_commit_code_health_safeguard`)以檢測回歸。如果 CodeHealth 下降或風險增加,請進入自我糾正的重構循環,直到達到閾值。
13) (可選) 為大型舊有重構啟用 ACE: 如果您擁有單獨的 ACE 附加授權,請向 MCP 伺服器提供 ACE 存取權杖,以加速非常大型函數的初始重構。ACE 是可選的;單獨的 MCP 通常就足夠了。
14) 讓您的團隊保持工作流程一致: 使用儲存庫指南 (AGENTS 檔案) 來標準化代理程式如何組合工具:及早運行審查,持續保護變更,並在 CodeHealth 下降時要求重構循環——這樣 AI 輔助編碼才能保持可維護性並避免技術債務。
CodeHealth MCP Server by CodeScene 常見問題
它是一個本地模型上下文協議 (MCP) 服務,讓 AI 編碼助理和代理在開發過程中存取 CodeScene 的 CodeHealth™ 分析,提供客觀的可維護性和變更風險訊號作為可操作的工具。











