@context-cn/mcp

为中国开发生态提供高质量框架文档的 MCP Server。通过 MCP 协议 对接 AI 编码助手，让 AI 基于真实文档而非记忆回答问题，减少幻觉和编码错误。

已收录框架

| 框架 | 说明 | |------|------| | Laravel | PHP 框架 | | ThinkPHP | PHP 框架 | | 企业微信 API | 开放平台接口 |

持续扩展中，欢迎提 Issue 建议收录。

快速开始

Claude Code

claude mcp add context-cn -- npx -y @context-cn/mcp

Cursor

Settings > MCP Servers，添加：

{
  "mcpServers": {
    "context-cn": {
      "command": "npx",
      "args": ["-y", "@context-cn/mcp"]
    }
  }
}

OpenClaw

通过 CLI 添加：

openclaw mcp set context-cn '{"command":"npx","args":["-y","@context-cn/mcp"]}'

或手动编辑 ~/.openclaw/config.json：

{
  "mcp": {
    "servers": {
      "context-cn": {
        "command": "npx",
        "args": ["-y", "@context-cn/mcp"]
      }
    }
  }
}

支持 DeepSeek 等 OpenAI 兼容模型，只要模型具备 tool use 能力即可正常调用。

Windsurf / Cline / 其他 MCP 客户端

配置格式相同，在对应客户端的 MCP 配置中添加上述 JSON 即可。

提供的工具

MCP Server 提供 3 个工具，AI 会自动按需调用：

search-libraries

搜索可用的框架和版本。

输入: { query: "laravel" }
返回: 框架名称、library_id、可用版本列表

list-modules

查看框架的完整模块结构（文档地图），帮助 AI 精确定位目标模块。

输入: { library_id: "laravel", version: "12.x" }
返回: 树形模块列表

query-docs

按主题搜索文档内容，返回包含参数说明、返回值的结构化文档，同时附带相关 FAQ。

输入: { library_id: "laravel", topic: "任务分发", module: "队列" }
返回: 匹配的文档片段 + 常见问题

工作原理

• 首次使用某框架时，自动从远端同步该框架文档到本地 SQLite 缓存（~/.context-cn/cache.db）
• 后续查询走本地 FTS5 全文搜索，毫秒级响应
• 后台增量同步，文档更新自动拉取，不阻塞查询
• 离线可用，无网络时使用本地缓存

环境要求

• Node.js >= 22.5.0

配置

支持通过环境变量自定义：

| 变量 | 说明 | 默认值 | |------|------|--------| | CONTEXT_CN_API_URL | 远端 API 地址 | https://context-cn.bangbangda.me | | CONTEXT_CN_DB_PATH | 本地缓存路径 | ~/.context-cn/cache.db |

License

MIT