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安装程序将:
- 确认目标目录
- 检查Python 3.13+(如果缺少,可以安装)
- 询问CocoIndex Postgres数据库使用哪个端口
- 自动检测存储库中的文件类型,并允许您进行确认
- 可选地安装一个提交后钩子以进行自动索引
- 创建一个
cocoindex/包含所有必要文件的目录 - 设置Python venv并安装依赖项
- 通过Docker启动Postgres(pgvector)
- 运行初始索引
- 自动配置
.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