code-index-mcp

一个可通过 npx 运行的 MCP 服务器，为 AI 工具提供代码索引与语义搜索能力。每次调用会执行按需增量同步，保证结果最新。

运行要求

- Node.js >= 18
- Qdrant（默认 http://localhost:6333）

快速开始

``bash
npx @hayhandsome/code-index-mcp
`

默认使用 stdio 传输，适配 MCP 客户端的子进程方式调用。

配置

$3

目录：~/.code-index-mcp/

config.json（非敏感）：
`json
{
"qdrantUrl": "http://localhost:6333",
"embedderProvider": "openai",
"modelId": "text-embedding-3-small",
"modelDimension": 1536,
"embeddingBatchSize": 60,
"searchMinScore": 0.2,
"searchMaxResults": 20,
"timeoutMs": 300000,
"openAiCompatibleBaseUrl": "http://localhost:1234",
"ollamaBaseUrl": "http://localhost:11434"
}
`

secrets.json（敏感）：
`json
{
"qdrantApiKey": "",
"openAiApiKey": "",
"openAiCompatibleApiKey": ""
}
`

$3

目录：/.code-index/

config.json / secrets.json 会覆盖全局配置。

$3

- CODE_INDEX_QDRANT_URL
- CODE_INDEX_QDRANT_API_KEY
- CODE_INDEX_EMBEDDER_PROVIDER
- CODE_INDEX_MODEL_ID
- CODE_INDEX_MODEL_DIMENSION
- CODE_INDEX_EMBEDDING_BATCH_SIZE
- CODE_INDEX_SEARCH_MIN_SCORE
- CODE_INDEX_SEARCH_MAX_RESULTS
- CODE_INDEX_TIMEOUT_MS
- CODE_INDEX_OPENAI_API_KEY
- CODE_INDEX_OPENAI_COMPATIBLE_API_KEY
- CODE_INDEX_OPENAI_COMPATIBLE_BASE_URL
- CODE_INDEX_OLLAMA_BASE_URL

MCP 工具

- code_index_search：按需同步后搜索
- code_index_update：执行一次增量同步
- code_index_reindex：清空并重建索引
- code_index_clear：清空向量与本地缓存
- code_index_status：查看当前配置与索引状态

$3

`json
{
"tool": "code_index_search",
"arguments": {
"query": "How is the config loaded?",
"workspacePath": "/path/to/repo"
}
}
`

忽略规则

- 自动读取 .gitignore
- 如果存在 .rooignore，会在 .gitignore` 基础上叠加

许可

MIT