vector-search-workflows

用途

Vector Search Workflows（MCP Vector Search）用于把代码库索引到 ChromaDB，并通过语义嵌入进行搜索。其推荐流程是：先 setup（初始化配置、建立索引、配置 MCP 集成），再进行 search 搜索，之后用 index 或 auto-index 保持数据新鲜。

主要能力

快速开始

安装与初始化命令：

pip install mcp-vector-search
mcp-vector-search setup
mcp-vector-search search "authentication logic"

setup 会检测语言、初始化配置、为仓库建立索引，并配置 MCP 集成（如 Claude Code、Cursor 等）。

索引

mcp-vector-search index
mcp-vector-search index --force
mcp-vector-search index reindex --all --force
mcp-vector-search index reindex path/to/file.py

自动索引策略

mcp-vector-search auto-index setup --method all
mcp-vector-search auto-index status
mcp-vector-search auto-index check --auto-reindex --max-files 10
mcp-vector-search auto-index teardown --method all

搜索

mcp-vector-search search "error handling patterns"
mcp-vector-search search "vector store initialization"

状态与诊断

mcp-vector-search status
mcp-vector-search doctor

使用方式

MCP 集成模式

setup 在可用时使用原生 claude mcp add，否则回退到 .mcp.json。典型的 .mcp.json 条目如下：

{
  "mcpServers": {
    "mcp-vector-search": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "mcp-vector-search", "mcp"],
      "env": {
        "MCP_ENABLE_FILE_WATCHING": "true"
      }
    }
  }
}

重建索引触发时机

• 依赖更新或解析器变更
• 大规模重构
• 新增语言或文件扩展名
• 工具升级（版本跟踪会触发重建索引）

本地实践

• 开发安装使用 uv：uv sync --dev
• 工具升级后使用 setup --force 重建配置与索引
• 通过 MCP_ENABLE_FILE_WATCHING=true 保持文件监视开启

适用场景

适用于需要将代码库索引到 ChromaDB 并通过语义嵌入检索的开发者工作流，尤其适合与 Claude Code、Cursor 等 MCP 集成环境配合使用，也适合需要自动索引与文件监视以保持索引数据更新的团队。

限制

关于收费、价格、平台兼容范围、索引规模上限或性能表现等，资料中暂未提供。