codekb-mcp 0.1.0

CodeKB Search MCP Server — AI Agent 代码知识库检索服务

CodeKB Search MCP Server

AI Agent 代码知识库检索服务 — 通过 MCP 协议将代码检索能力接入 Claude Code / OpenCode / Codex 等 AI 终端。

安装

# 推荐：uvx 自动拉取运行，无需预装
uvx codekb-mcp

# 或 pip 安装
pip install codekb-mcp

配置

环境变量

变量	默认值	说明
CODEKB_API_URL	http://localhost:8000/api/v1	CodeKB API 地址

OpenCode (opencode.json)

{
  "mcp": {
    "codekb-search": {
      "type": "local",
      "command": ["uvx", "codekb-mcp"],
      "enabled": true,
      "environment": {
        "CODEKB_API_URL": "http://your-server:8000/api/v1"
      }
    }
  }
}

Claude Code (.mcp.json)

{
  "mcpServers": {
    "codekb-search": {
      "command": "uvx",
      "args": ["codekb-mcp"],
      "env": {
        "CODEKB_API_URL": "http://your-server:8000/api/v1"
      }
    }
  }
}

Codex (.codex/config.toml)

[mcp_servers.codekb-search]
command = "uvx"
args = ["codekb-mcp"]
env = { CODEKB_API_URL = "http://your-server:8000/api/v1" }
enabled = true
startup_timeout_sec = 30

可用工具

工具	说明
codekb_list_repos	列出可用仓库
codekb_get_repo_card	仓库导航卡片（首次必调）
codekb_search	多路代码检索 (<200ms)
codekb_symbol_search	符号搜索
codekb_graph_expand	调用链扩展
codekb_graph_path	调用路径查询
codekb_file_knowledge	文件级知识

使用流程

1. codekb_list_repos → 了解有哪些仓库
2. codekb_get_repo_card → 获取仓库结构、业务域、可用过滤条件
3. codekb_search → 按语义/代码/结构/关键词多路检索
4. codekb_graph_expand / codekb_graph_path → 追踪调用链
5. codekb_file_knowledge → 深入了解文件设计

License

MIT