mcpField
V
vector-search-workflows

vector-search-workflows

github.com/bobmatnyc开发78319 次安装15 周前更新
代码仓库

关于 vector-search-workflows

这是一套命令行工作流，可将代码库索引到 ChromaDB，并通过语义嵌入搜索，面向开发者提供配置、索引维护及与 Claude Code、Cursor 等客户端的 MCP 集成。

主要功能

  1. 01将代码库索引到 ChromaDB
  2. 02通过语义嵌入搜索
  3. 03初始化配置并创建索引
  4. 04重建指定文件或代码库的索引
  5. 05配置自动索引
  6. 06查看状态并诊断设置

适用场景

  1. 01在仓库中查找身份验证逻辑
  2. 02搜索错误处理模式
  3. 03重构后更新索引
  4. 04为代码库配置 MCP 集成

MCP 相关

setup 命令会配置 MCP 集成；若可用则使用 `claude mcp add`，否则写入 `.mcp.json`。该项目可通过 stdio 作为 MCP 服务运行。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bobmatnyc/claude-mpm-skills --skill vector-search-workflows

安装后在 Claude Code 中输入/vector-search-workflows确认已加载。

附带文件metadata.json

详细介绍

向量搜索工作流（MCP Vector Search）

概述

使用 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 集成模式

如果 claude mcp add 可用，setup 会使用该命令；否则会回退到 .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

相关技能

  • toolchains/ai/protocols/model-context
  • universal/main/model-context-builder

评论

支持 Markdown