What are the requirements to run Sourcerer MCP?
An OpenAI API Key is required for generating embeddings. The project must be a Git repository, and you should add `.sourcerer/` to your `.gitignore` to ignore the vector database directory.
@st3v3nmw
Basic information
An MCP server for semantic code search & navigation that helps AI agents work efficiently without burning through costly tokens. Instead of reading entire files, agents can search conceptually and jump directly to the specific functions, classes, and code chunks they need.
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"sourcerer": {
"command": "sourcerer",
"env": {
"OPENAI_API_KEY": "your-openai-api-key",
"SOURCERER_WORKSPACE_ROOT": "/path/to/your/project"
}
}
}
}Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Sourcerer MCP is an MCP server for semantic code search and navigation. It helps AI agents find specific functions, classes, and code chunks using conceptual search instead of reading entire files, reducing token usage and cognitive load.
Install via go install or Homebrew. Configure with an OpenAI API key and workspace root path, then add the server to your MCP client (e.g., Claude Code or mcp.json). Once configured, agents can call tools like semantic_search and get_source_code to query and retrieve code.
.gitignore rules.sourcerer/db/An OpenAI API Key is required for generating embeddings. The project must be a Git repository, and you should add `.sourcerer/` to your `.gitignore` to ignore the vector database directory.
It provides `semantic_search` (find code by concept), `get_source_code` (retrieve a chunk by ID), `index_workspace` (manually trigger re-indexing), and `get_index_status` (check indexing progress).
Only Go is currently supported. Python, TypeScript, and JavaScript are planned. Adding support for new languages requires writing Tree-sitter queries.
It watches for file changes using `fsnotify`, respects `.gitignore` via `git check-ignore`, and automatically re-indexes changed files while tracking modification times.
The vector database is stored persistently in the `.sourcerer/db/` directory within the workspace root.
Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Hindsight: Agent Memory That Learns
YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Comments