Sourcerer

Install sourcerer via go install or the Homebrew tap. Both methods produce the same binary.

# Via Go
go install github.com/st3v3nmw/sourcerer-mcp/cmd/sourcerer@latest

# Via Homebrew (macOS)
brew tap st3v3nmw/tap
brew install st3v3nmw/tap/sourcerer

The claude mcp add command registers the server and sets the required environment variables. Run it from the root of the project you want to index.

claude mcp add sourcerer \
  -e OPENAI_API_KEY=sk-your-openai-key \
  -e SOURCERER_WORKSPACE_ROOT=$(pwd) \
  -- sourcerer

Add the server entry to your mcp.json or claude_desktop_config.json. Use the absolute path for SOURCERER_WORKSPACE_ROOT.

{
  "mcpServers": {
    "sourcerer": {
      "command": "sourcerer",
      "env": {
        "OPENAI_API_KEY": "sk-your-openai-key",
        "SOURCERER_WORKSPACE_ROOT": "/absolute/path/to/your/project"
      }
    }
  }
}

On first run, trigger workspace indexing. Ask the AI agent to call the index_workspace tool, or include it in your initial prompt. Indexing reads all supported source files and creates vector embeddings.

For large codebases, indexing can take a few minutes. Use the get_index_status tool to check progress before starting searches.

Use semantic_search to find code by concept, get_chunk_code to retrieve a specific chunk's full source, and find_similar_chunks to locate analogous patterns elsewhere in the codebase.