Agent skill

vector-search-workflows

Vector search indexing and querying workflows using MCP Vector Search, including setup, reindexing, auto-index strategies, and MCP integration.

View SKILL.md on GitHub Repository
Stars 28
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/bobmatnyc/claude-mpm-skills/tree/main/toolchains/ai/techniques/vector-search-workflows

SKILL.md

Vector Search Workflows (MCP Vector Search)

Overview

Use mcp-vector-search to index codebases into ChromaDB and search via semantic embeddings. The recommended flow is setup (init + index + MCP integration), then search, and use index or auto-index to keep data fresh.

Quick Start

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

setup detects languages, initializes config, indexes the repo, and configures MCP integrations (Claude Code, Cursor, etc.).

Core Commands

Indexing

bash
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

Auto-Index Strategies

bash
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

Search

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

Status + Doctor

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

MCP Integration Pattern

setup uses native claude mcp add when available, otherwise falls back to .mcp.json.

Typical .mcp.json entry:

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

Reindex Triggers

  • Dependency updates or parser changes
  • Large refactors
  • Adding new languages or file extensions
  • Tool upgrades (version tracking triggers reindex)

Local Patterns

  • Use uv for dev installs: uv sync --dev
  • Use setup --force to rebuild config + index after tool upgrades
  • Keep file watching on via MCP_ENABLE_FILE_WATCHING=true

Related Skills

  • toolchains/ai/protocols/mcp
  • universal/main/mcp-builder

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

bobmatnyc/claude-mpm-skills

bad-example-skill

ANTI-PATTERN - Example showing violations of self-containment (DO NOT COPY)

28 8
Explore
bobmatnyc/claude-mpm-skills

example-framework-skill

Example of a properly self-contained skill following all best practices

28 8
Explore
bobmatnyc/claude-mpm-skills

systematic-debugging

Systematic debugging methodology emphasizing root cause analysis over quick fixes

28 8
Explore
bobmatnyc/claude-mpm-skills

verification-before-completion

Run verification commands and confirm output before claiming success

28 8
Explore
bobmatnyc/claude-mpm-skills

Root Cause Tracing

Systematically trace bugs backward through call stack to find original trigger

28 8
Explore
bobmatnyc/claude-mpm-skills

Brainstorming Ideas Into Designs

Interactive idea refinement using Socratic method to develop fully-formed designs

28 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results