MCP Server
Context Chain 通过 MCP 服务暴露知识图谱,提供 9 个工具。任何 MCP 兼容的 coding AI 都可以在写代码时查询设计决策。
工具
get_context_for_code
主入口。对一段代码做五槽位检索。
| 参数 | 类型 | 说明 |
|---|---|---|
file_path | string | 当前编辑的文件 |
function_name | string | (可选)具体函数 |
code_snippet | string | (可选)代码片段,用于语义匹配 |
按优先级查询五个槽位:代码锚点 → 关键词 → 决策关联 → 语义兜底,全程叠加元数据过滤。返回排序后的决策摘要;需要完整内容可再次请求。
search_decisions_by_keyword
直接走倒排索引做关键词搜索。能捕获代码中不存在的业务术语("退款"、"鉴权"、"限流")。
| 参数 | 类型 | 说明 |
|---|---|---|
keywords | string[] | 搜索词 |
repo | string | (可选)限定 repo |
search_decisions_semantic
向量相似度搜索。适合决策描述和搜索用词不一致的场景——搜"防止重复扣款"能找到关于"幂等性设计"的决策。
| 参数 | 类型 | 说明 |
|---|---|---|
query | string | 自然语言查询 |
limit | number | (可选)最大结果数 |
get_decision_relationships
探索一条决策的因果、依赖、冲突链。
| 参数 | 类型 | 说明 |
|---|---|---|
decision_id | string | 起始决策 |
depth | number | (可选)跳几层 |
get_code_structure
查某个文件或服务下有哪些函数。
| 参数 | 类型 | 说明 |
|---|---|---|
path | string | 文件路径或服务名 |
type | string | 过滤:function、file、service |
get_callers
上游依赖——谁调用了这个函数。
| 参数 | 类型 | 说明 |
|---|---|---|
function_name | string | 要查的函数 |
repo | string | repo 范围 |
get_callees
下游依赖——这个函数调用了谁。
| 参数 | 类型 | 说明 |
|---|---|---|
function_name | string | 要查的函数 |
repo | string | repo 范围 |
get_cross_repo_dependencies
跨服务 API 依赖。展示服务之间通过 API 调用、共享包和消息队列的连接关系。
| 参数 | 类型 | 说明 |
|---|---|---|
repo | string | 要检查的 repo |
report_context_usage
反馈回路——报告哪些决策在编程过程中真正被用到了。用于优化检索排序。
| 参数 | 类型 | 说明 |
|---|---|---|
decision_ids | string[] | 被使用的决策 |
session_context | string | (可选)当时在做什么 |
启动
bash
npm run mcp通过 stdio 通信。通常由 Claude Code 通过 .mcp.json 自动启动。