doc-hub-mcp

This project has moved / 项目已迁移

本项目已停止维护，全新版本已迁移至：SpecFusion

This project is no longer maintained. Please use the new repository: SpecFusion

为什么迁移？

doc-hub-mcp 采用 MCP Server + Markdown 文件打包的方案，存在以下问题：

• 架构笨重 — 作为 MCP Server 运行，需要独立进程，配置繁琐
• 包体积过大 — 每次安装需下载 100+ MB 文档数据，首次启动慢
• 平台覆盖有限 — 仅支持企业微信和飞书两个平台
• 检索能力弱 — 基于简单的文件名和内容匹配，缺乏中文分词能力
• 更新不便 — 文档更新需要重新发布 npm 包，用户需重新下载全量数据

SpecFusion 的改进

新项目 SpecFusion 从方案到架构做了全面升级，最大的变化是从 MCP Server 方案转为 Claude Code Skill 方案：

	doc-hub-mcp (旧)	SpecFusion (新)
方案	MCP Server（独立进程）	Claude Code Skill（零进程，即装即用）
平台覆盖	2 个（企微、飞书）	15+ 个（企微、飞书、钉钉、淘宝、小红书、抖音、微信小程序、拼多多、支付宝等）
文档规模	~3,000 篇	26,800+ 篇，17,900+ 个 API 端点
检索方案	文件名 + 内容简单匹配	jieba 中文分词 + SQLite FTS5 全文索引
部署方式	npm 包（文档打包分发）	云端服务零配置 / Docker 自部署
更新机制	重新发布 npm 包	服务端实时更新，客户端无感

Skill 相比 MCP Server 的优势在于：无需启动额外进程、无需管理连接状态、安装只需一条命令、提及平台名即可自动触发检索。

---

以下为旧版说明，仅供参考。

---

企业微信 & 飞书开放平台文档检索 MCP 服务。

让 AI 编程助手直接检索企微/飞书的开发者文档，在写代码时随时查阅接口说明，无需切换浏览器。

安装

Claude Code

claude mcp add doc-hub-mcp -- npx -y doc-hub-mcp@latest

Codex

codex mcp add doc-hub-mcp -- npx -y doc-hub-mcp@latest

Cursor

打开 Settings → Features → MCP → Add New MCP Server，输入：

• Type: stdio
• Command: npx -y doc-hub-mcp@latest

或直接点击安装：Install in Cursor

提示：首次安装需下载约 100 MB 文档数据，请耐心等待。后续启动使用缓存，速度会快很多。

使用

安装完成后，直接向 AI 提问即可，它会自动调用文档检索：

• "企业微信如何获取外部联系人列表？"
• "飞书如何发送消息卡片？"
• "企微审批流程怎么对接？"

配置（可选）

环境变量

变量名	说明	默认值
DOC_ROOT	自定义文档根目录	包内 wecom/、feishu/
DOC_NAMESPACE	资源命名空间	local-docs
MCP_SERVER_NAME	服务显示名称	doc-hub

带环境变量安装示例（Claude Code）：

claude mcp add doc-hub-mcp -e DOC_ROOT=/path/to/docs -- npx -y doc-hub-mcp@latest

手动配置文件

如果需要手动编辑配置文件：

Claude Code (~/.claude.json)：

{
  "mcpServers": {
    "doc-hub-mcp": {
      "command": "npx",
      "args": ["-y", "doc-hub-mcp@latest"]
    }
  }
}

Codex (~/.codex/config.toml)：

[mcp_servers.doc-hub-mcp]
command = "npx"
args = ["-y", "doc-hub-mcp@latest"]

Cursor (.cursor/mcp.json)：

{
  "mcpServers": {
    "doc-hub-mcp": {
      "command": "npx",
      "args": ["-y", "doc-hub-mcp@latest"]
    }
  }
}

支持的文档

• 企业微信 — 服务端 API、客户端 API、应用开发、智慧硬件等
• 飞书开放平台 — 开发指南、服务端 API、消息卡片、小程序等

文档更新时间：2026-01-19

故障排查

问题	解决方案
首次加载缓慢	正常现象，需下载 100+ MB 文档数据，等待 2-5 分钟
工具不显示	检查配置文件 JSON/TOML 格式是否正确，重启 IDE
文档目录不存在	通过 DOC_ROOT 环境变量指定正确路径

本地开发

npm install
npm run mcp:server --silent

# MCP Inspector 调试
npx @modelcontextprotocol/inspector -s "npm run mcp:server --silent"

数据抓取

npm run scrape:wecom                   # 企业微信全量抓取
npm run scrape:feishu                  # 飞书全量抓取
npm run scrape:wecom -- --limit 20     # 仅抓取 20 篇验证