CKB

社区

了解你的代码。安全地修改。自信地发布。

分类: 开发工具第 327 / 438
Stars: ★ 110 热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 28 天前
工具数: 39

43FMRS · D

CKB是一个功能丰富的代码智能MCP服务器，提供丰富的工具集（80+），涵盖导航、影响分析、架构、安全、所有权和质量。其复合操作和预设可显著减少AI token消耗。主要优势是静态分析能力和支持多种语言，但质量参差不齐（Go最好，PHP实验性）。它需要索引，可能过时，且不处理动态行为。总体而言，非常适用于重构、审阅和AI辅助开发，但需注意静态分析的限制和索引维护。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

6/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: 所给材料只有清单、README 和元数据，没有仓库源码、CI 或测试，无法验证 MCP 启动、init 握手和工具列表与真实行为是否一致。清单中的仓库地址指向 SimplyLiz/CodeMCP 而非 ckb，manifest 版本 8.0.3 与 README 中的 v9.3.0 不一致，工具数量也有 80+ 和 110 的矛盾描述，因此按保守原则明显下调评分。
安全与权限 8/20: 未发现恶意代码、凭据窃取、真实密钥样例等红线问题；文档宣称有 token 作用域、secret 扫描和 allowlist。但源码未提供，无法核实凭据存储方式、最小权限、危险操作确认机制；HTTP 服务和可选 LIP daemon 会扩大攻击面，缺少可复核的实现证据，故不能给高分。
维护活跃度 6/20: 仓库未归档且有 open issues，README 提到 npm 包和 changelog，但许可证为 NOASSERTION，没有明确授权条款；提交记录、发布节奏、依赖更新和安全响应渠道均无法从所给材料验证，仓库身份和版本描述的不一致进一步削弱信心。
文档质量 12/20: README 覆盖安装、CLI、HTTP API、MCP 客户端配置、preset、限制与 wiki 链接，具有一定的分层文档基础；但工具参数、故障排查和成本细节主要依赖外部 wiki，未提供可复核证据；版本号与工具数量的矛盾也降低了文档可信度。
安装易用性 12/20: 安装路径看起来清晰：npm/npx 一条命令，并提供多个客户端配置示例、Windows 包装和环境变量说明。但静态材料中没有 CI 或测试证据证明该路径可执行，manifest 仓库地址与 README 克隆地址不一致也会造成溯源困惑；按照静态校准上限 15，保守给 12。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件

适合谁

使用AI编码助手并希望它们具有精确代码感知能力的开发者
拥有大型代码库且需要高效导航的团队
任何希望安全重构的人
需要全面变更视角的代码审阅者
追踪架构健康度的技术负责人

不适合谁

动态调度或运行时行为分析（需要使用调试器）
未索引的生成代码
代码生成、代码检查或格式化
跨仓库调用（可使用federation）

所需权限

读取代码库文件和git历史
生成和维护SCIP索引（本地文件）
执行指定的MCP服务器进程（stdio）
可选：在访问索引时创建API令牌以进行身份验证
可选的网络访问，用于运行HTTP API服务器

风险与副作用

SCIP索引可能过时，导致引用或影响分析不准确
索引较大的代码库可能消耗大量时间和磁盘
动态或反射代码可能被错误分析
可能需要安装SCIP索引器，不同语言的支持质量不同
输入未经静默验证，因此需验证输出

安装接入

准备工作

运行环境：Node.js 16+

其他可选配置项（1 个）

CKB_REPO 可选指定要分析的仓库路径；仅在 Claude Desktop 等无项目上下文的客户端中必须设置，路径由用户自行指定。

可选方案：1) npm（推荐）：npm install -g @tastehub/ckb；2) Homebrew（macOS/Linux）：brew tap SimplyLiz/ckb && brew install ckb；3) 从源码构建：git clone https://github.com/SimplyLiz/CodeMCP.git && cd CodeMCP && go build -o ckb ./cmd/ckb。安装后，在项目目录运行ckb init，可选地运行ckb index生成SCIP索引，然后运行ckb setup连接Claude Code。您也可以手动在MCP配置中使用npx @tastehub/ckb mcp。

claude_desktop_config.json

{
  "mcpServers": {
    "ckb": {
      "command": "npx",
      "args": [
        "@tastehub/ckb",
        "mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "ckb": {
      "command": "npx",
      "args": [
        "@tastehub/ckb",
        "mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add ckb -- npx @tastehub/ckb mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在项目目录运行 ckb init 和 ckb index 后，用 npx @tastehub/ckb mcp 启动服务器；在客户端工具列表中应出现 explore、understand、impactAnalysis 等工具，并可用“这个函数被谁调用”之类的问题验证索引是否生效。

常见排障

运行`ckb status`检查系统健康
运行`ckb doctor --tier standard`检查语言工具
如果索引过时，运行`ckb index`或使用`ckb mcp --watch`
对于TypeScript monorepos，可能需要`--infer-tsconfig`标志
C/C++需要`compile_commands.json`
对于最佳搜索质量，手动安装LIP守护进程，或使用`cargo install lip-cli && lip daemon --socket ~/.local/share/lip/lip.sock`启动

试试这样问

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

哪些函数调用了 HandleRequest？
如果修改 UserService，影响范围（blast radius）有多大？
谁负责 internal/api 模块？推荐哪些审阅者？
扫描一下这个仓库有没有暴露的密钥

工具能力 39

explore 只读

区域探索：符号、依赖、热点

understand 只读

符号深潜：引用、调用者、解释

prepareChange 只读

变更前分析：影响、测试、风险

batchGet 只读

一次获取最多50个符号

batchSearch 只读

一次运行最多10个搜索

searchSymbols 只读

语义搜索符号

findReferences 只读

查找对符号的所有引用

callGraph 只读

生成调用图

展开其余 31 个工具

traceUsage 只读

追踪符号的使用

findEntrypoints 只读

找到代码入口点

impactAnalysis 只读

分析变更的影响范围

riskScore 只读

计算风险分数

affectedTests 只读

找出受影响的测试

compareAPI 只读

比较API向后兼容性

blastRadius 只读

确定爆炸半径

architecture 只读

获取架构概览

moduleOverview 只读

获取模块概览

adrs 只读

检索架构决策记录

dependencyGraph 只读

生成依赖图

explainOrigin 只读

解释符号的起源

findDeadCode 只读

检测死代码

couplingAnalysis 只读

分析耦合度

complexity 只读

计算代码复杂度

hotspots 只读

识别热点区域

ownership 只读

查找代码所有权

reviewerSuggestions 只读

推荐审阅者

driftDetection 只读

检测所有权漂移

detectSecrets 只读

检测暴露的秘密

scanCredentials 只读

扫描凭据

securitySensitive 只读

识别安全敏感代码

docSymbols 只读

文档-符号链接

docStaleness 只读

检查文档过期

docCoverage 只读

文档覆盖率指标

federation 只读

跨仓库查询

openTelemetry 只读

OpenTelemetry集成

observedUsage 只读

观察生产环境使用

streamReferences 只读

流式传输引用

streamSearch 只读

流式传输搜索结果

expandToolset 只读

动态扩展工具集

使用场景

AI辅助开发（Claude Code、Cursor等）中的语义代码导航

重构前的影响分析和风险评分

识别受影响的测试以缩小测试范围

通过CODEOWNERS和git blame进行代码所有权跟踪和审阅者推荐

死代码检测和技术债务跟踪

秘密扫描和凭据检测以增强安全性

架构映射和模块理解

CI/CD集成，用于PR审查和质量门禁

支持客户端

Claude Desktop

Claude Code

Cursor

Windsurf

VS Code

OpenCode

Grok

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

详细介绍

CKB（代码知识后端）将你的代码库转化为可查询的知识库。它提供80多个MCP工具、CLI和HTTP API，实现符号导航、影响分析、架构映射、死代码检测、秘密扫描、代码所有权等功能。利用SCIP索引、LSP、Git和可选的LIP语义嵌入，为AI助手提供精确的代码智能，或作为CI/CD和自定义工具的后端。它支持如explore、understand和prepareChange等复合操作，可将AI工具调用减少60-70%，并通过预设减少高达77%的token用量。CKB采用分层语言支持，其中Go、TypeScript、JavaScript和Python最佳。

CKB