使用教程 - Code:Pop

01克隆项目并启动

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

等待服务启动，访问 http://localhost:3000 打开管理后台。

进入 GitHub 仓库 Settings → Webhooks → Add webhook

配置项	值
Payload URL	`http://你的服务器:8080/webhook/github`
Content type	`application/json`
Secret	与 `.env` 里的 `GITHUB_WEBHOOK_SECRET` 一致
Events	选 `Push`

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

在 Claude Code 的 MCP 配置中添加：

{
  "mcpServers": {
    "codepop": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-codepop"]
    }
  }
}

Cursor Settings → MCP → Add Server，填写 CodePop 的 SSE endpoint。

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

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

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

CodePop 同时用四种方式检索代码，确保不遗漏：

通过 tree-sitter 解析代码结构，按函数、类、方法精准定位。

BAAI/bge-m3 将代码转为 1024 维向量，理解语义而非字面。

经典文本检索，补充精确匹配能力。

模糊匹配，容错拼写差异和相近词。