canpoint-knowledge-mcp

面向业务项目的知识库 MCP。安装后，AI 助手可以直接检索和阅读你项目的知识库 文档：查大纲、混合检索、读全文与章节、沿文档引用关系跳转；项目发布后， 还能一键把最新的 docs/ 同步进知识库。

能做什么

查询 MCP（只读，绑定一个项目）：

同步 MCP（发布后更新知识库）：

怎么用

前提：

• 一个可访问的 KB2 知识库服务（通常由团队统一部署，向管理员要地址）
• 通过 npm 使用时需要先安装 uv

启动前设置两个环境变量，把 MCP 绑定到服务和项目：

KB_SERVER_URL=http://your-kb-service:8001
KB_PROJECT_KEY=your-project

Claude Code 配置示例（.mcp.json）：

{
  "mcpServers": {
    "kb2-query": {
      "command": "npx",
      "args": ["-y", "canpoint-knowledge-mcp"],
      "env": {
        "KB_SERVER_URL": "http://your-kb-service:8001",
        "KB_PROJECT_KEY": "your-project"
      }
    },
    "kb2-sync": {
      "command": "npx",
      "args": ["-y", "--package", "canpoint-knowledge-mcp", "kb2-sync-mcp"],
      "env": {
        "KB_SERVER_URL": "http://your-kb-service:8001",
        "KB_PROJECT_KEY": "your-project"
      }
    }
  }
}

也可以用 Python 方式安装运行：

pip install canpoint-knowledge-mcp   # 提供 kb2-query-mcp / kb2-sync-mcp 命令
uvx canpoint-knowledge-mcp            # 免安装直接运行查询 MCP

Codex 配置示例（~/.codex/config.toml）：

[mcp_servers.kb2-query]
type = "stdio"
command = "npx"
args = ["-y", "canpoint-knowledge-mcp"]

[mcp_servers.kb2-query.env]
KB_SERVER_URL = "http://your-kb-service:8001"
KB_PROJECT_KEY = "your-project"

[mcp_servers.kb2-sync]
type = "stdio"
command = "npx"
args = ["-y", "--package", "canpoint-knowledge-mcp", "kb2-sync-mcp"]

[mcp_servers.kb2-sync.env]
KB_SERVER_URL = "http://your-kb-service:8001"
KB_PROJECT_KEY = "your-project"

Windows 下若 npx 启动失败，可把 command 改为 cmd、args 改为 ["/c", "npx", "-y", "canpoint-knowledge-mcp"]（env 表不变）。

推荐的发布规则（写入业务项目的 AGENTS.md）：

发布成功后调用同步 MCP 的 sync_now(project_root="<当前项目绝对根目录>")；
取得并汇报已受理的 job_id 后继续发布流程；除非知识库索引完成是发布门禁，
否则不要等待或轮询 sync_status。

项目

• 仓库与完整文档：https://github.com/mjwyr/canpoint-mcp
• 作者：若清风
• 协议：Apache-2.0