Sourcegraph MCP Server
A Model Context Protocol (MCP) server that provides AI-enhanced code search capabilities using Sourcegraph.
Table of Contents
Related MCP server: PapersWithCode MCP
Overview
This MCP server integrates with Sourcegraph, a universal code search platform that enables searching across multiple repositories and codebases. It provides powerful search capabilities with advanced query syntax, making it ideal for AI assistants that need to find and understand code patterns across large codebases.
Features
Code Search: Search across codebases using Sourcegraph's powerful query language
Advanced Query Language: Support for regex patterns, file filters, language filters, and boolean operators
Repository Discovery: Find repositories by name and explore their structure
Content Fetching: Browse repository files and directories
AI Integration: Designed for LLM integration with guided search prompts
Prerequisites
Sourcegraph Instance: Access to a Sourcegraph instance (either sourcegraph.com or self-hosted)
Python 3.10+: Required for running the MCP server
UV (optional): Modern Python package manager for easier dependency management
Installation
Using UV (recommended)
Using pip
Using Docker
Configuration
Required Environment Variables
SRC_ENDPOINT: Sourcegraph instance URL (e.g., https://sourcegraph.com)
Optional Environment Variables
SRC_ACCESS_TOKEN: Authentication token for private Sourcegraph instancesMCP_SSE_PORT: SSE server port (default: 8000)MCP_STREAMABLE_HTTP_PORT: HTTP server port (default: 8080)
Usage with AI Tools
Cursor
After running the MCP server, add the following to your .cursor/mcp.json file:
MCP Tools
This server provides three powerful tools for AI assistants:
🔍 search
Search across codebases using Sourcegraph's advanced query syntax with support for regex, language filters, and boolean operators.
📖 search_prompt_guide
Generate a context-aware guide for constructing effective search queries based on your specific objective.
📂 fetch_content
Retrieve file contents or explore directory structures from repositories.