Back to search
sourcerer-mcp
MCP serverGitHub
MCP for semantic code search & navigation that reduces token waste
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/st3v3nmw--sourcerer-mcp)HTML
<a href="/listings/st3v3nmw--sourcerer-mcp"><img src="/api/listings/st3v3nmw--sourcerer-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Go
go install github.com/st3v3nmw/sourcerer-mcp/cmd/sourcerer@latest
Homebrew
brew tap st3v3nmw/tap brew install st3v3nmw/tap/sourcerer
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 110 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Sourcerer MCP 🧙
- 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.
- ## Demo
- [](https://asciinema.org/a/736638)
- ## Requirements
- - **OpenAI API Key**: Required for generating embeddings (local embedding support planned)
- - **Git**: Must be a git repository (respects `.gitignore` files)
- - **Add `.sourcerer/` to `.gitignore`**: This directory stores the embedded vector database
- ## Installation
- ### Go
- ```shell
- go install github.com/st3v3nmw/sourcerer-mcp/cmd/sourcerer@latest
- ```
- ### Homebrew
- ```shell
- brew tap st3v3nmw/tap
- brew install st3v3nmw/tap/sourcerer
- ```
- ## Configuration
- ### Claude Code
- ```shell
- claude mcp add sourcerer -e OPENAI_API_KEY=your-openai-api-key -e SOURCERER_WORKSPACE_ROOT=$(pwd) -- sourcerer
- ```
- ### mcp.json
- ```json
- {
- "mcpServers": {
- "sourcerer": {
- "command": "sourcerer",
- "env": {
- "OPENAI_API_KEY": "your-openai-api-key",
- "SOURCERER_WORKSPACE_ROOT": "/path/to/your/project"
- }
- }
- }
- }
- ```
- ## How it Works
- Sourcerer 🧙 builds a semantic search index of your codebase:
- ### 1. Code Parsing & Chunking
- - Uses [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) to parse source files into ASTs
- - Extracts meaningful chunks (functions, classes, methods, types) with stable IDs
- - Each chunk includes source code, location info, and contextual summaries
- - Chunk IDs follow the format: `file.ext::Type::method`
- ### 2. File System Integration
- - Watches for file changes using `fsnotify`
- - Respects `.gitignore` files via `git check-ignore`
- - Automatically re-indexes changed files
- - Stores metadata to track modification times
- ### 3. Vector Database
- - Uses [chromem-go](https://github.com/philippgille/chromem-go) for persistent vector storage in `.sourcerer/db/`
- - Generates embeddings via OpenAI's API for semantic similarity
- - Enables conceptual search rather than just text matching
- - Maintains chunks, their embeddings, and metadata
- ### 4. MCP Tools
- - `semantic_search`: Find relevant code using semantic search
- - `get_chunk_code`: Retrieve specific chunks by ID
- - `find_similar_chunks`: Find similar chunks
- - `index_workspace`: Manually trigger re-indexing
- - `get_index_status`: Check indexing progress
- This approach allows AI agents to find relevant code without reading entire files,
- dramatically reducing token usage and cognitive load.
- ## Supported Languages
- Language support requires writing [Tree-sitter queries](https://github.com/st3v3nmw/sourcerer-mcp/blob/main/internal/parser/go.go) to
- identify functions, classes, interfaces, and other code structures for each language.
- **Supported:** Go, JavaScript, Markdown, Python, TypeScript
- **Planned:** C, C++, Java, Ruby, Rust, and others
- ## Contributing
- All contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
- ```
- $ ls @stephenmwangi.com
- - gh:st3v3nmw/obsidian-spaced-repetition
- - gh:st3v3nmw/lsfr
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.