Cocoindex MCP

CocoIndex MCP

通过以下方式将语义代码搜索添加到任何项目中 CocoIndex + 主控程序。您的repo根目录中的一个命令为Claude（或任何MCP客户端）提供了理解代码库的工具。

先决条件

• 码头工人
• Python 3.13+
• Git

安装

从项目的根目录：

curl -sSL https://raw.githubusercontent.com/zulandar/cocoindex-mcp/refs/heads/main/install.sh | bash

安装程序将：

1. 确认目标目录
2. 检查Python 3.13+（如果缺少，可以安装）
3. 询问CocoIndex Postgres数据库使用哪个端口
4. 自动检测存储库中的文件类型，并允许您进行确认
5. 可选地安装一个提交后钩子以进行自动索引
6. 创建一个 cocoindex/ 包含所有必要文件的目录
7. 设置Python venv并安装依赖项
8. 通过Docker启动Postgres（pgvector）
9. 运行初始索引
10. 自动配置 .mcp.json 在您的repo根目录中

用法

安装后，MCP服务器将在中自动配置 .mcp.json 在您的repo根目录下。有两种工具可供选择：

• search_code --对索引文件进行语义搜索。默认情况下返回已排序的代码段；集 include_code=True 对于整块。支持 top_k 和 min_score 参数。
• get_project_structure --返回所有索引源文件的树视图。

手动重新索引

cd cocoindex && .venv/bin/cocoindex update main.py

编辑索引模式

编辑 cocoindex/cocoindex.yaml 添加或删除文件扩展名并排除模式，然后重新索引。

创造什么

your-project/
  .mcp.json               # MCP server config (auto-created/updated)
  cocoindex/
    .venv/                # Python virtual environment
    .env                  # Database connection string
    .gitignore            # Ignores .venv and __pycache__
    cocoindex.yaml        # Include/exclude patterns and config
    docker-compose.yml    # pgvector Postgres service
    main.py               # CocoIndex flow definition
    mcp_server.py         # MCP server with search_code + get_project_structure
    requirements.txt      # Python dependencies