5 分钟跑起来

01克隆项目并启动

$ git clone https://github.com/ilyuve/code-pop.git
$ cd code-pop
$ docker compose up -d

等待服务启动，访问 http://localhost:13000 打开管理后台（Docker Compose 将 Web 容器内 3000 端口映射到宿主机 13000）。

02配置 GitHub Webhook

进入 GitHub 仓库 Settings → Webhooks → Add webhook

配置完成后，每次 push 代码会自动触发索引更新。

端口说明：Docker Compose 默认将后端容器内 8080 映射到宿主机 18080；若你的部署方式为 8080 直通，则使用 :8080。

03MCP 接入 AI 工具

Claude Code

在 Claude Code 的 MCP 配置中添加（原生 Streamable HTTP 直连，无需 npx 转发，请将 18080 换成你的实际端口）：

{
  "mcpServers": {
    "codepop": {
      "type": "http",
      "url": "http://localhost:18080/mcp/sse"
    }
  }
}

Cursor

Cursor Settings → MCP → Add Server，选择 HTTP 类型，URL 填写 http://localhost:18080/mcp/sse（端口按你的部署调整）。或写入项目根目录 .cursor/mcp.json：

{
  "mcpServers": {
    "codepop": {
      "type": "http",
      "url": "http://localhost:18080/mcp/sse"
    }
  }
}

使用方式

接入后直接在 AI 对话中输入：

帮我找一下用户登录的 JWT 验证逻辑
这个项目里哪里做了限流？

AI 会自动调用 CodePop 查询你的代码库并返回结果。

04核心概念：多路召回

CodePop 同时用五种方式检索代码，再经 RRF 融合 + 重排确保不遗漏：

05环境变量