Code Search MCP Server

Semantic code search, symbol lookup, call graphs, dependency graphs, ownership maps, and context pack generation for ADK-Rust Enterprise agents. Provides 8 MCP tools that work against any local workspace.

Architecture

Key Principles

Workspace-local — searches your actual codebase on disk, not a remote index.
Multi-language — supports Rust, TypeScript, Python, Go, Java, JavaScript.
Structural awareness — understands symbols, call graphs, dependencies, and ownership.
Context packs — gather related files, deps, and tests for LLM context windows.
Zero config — point at a directory and search. No indexing step required.
Registry-ready — ships with mcp-server.toml for ADK-Rust Enterprise onboarding.

Tools (8)

| Tool | Purpose | Risk Class | |------|---------|------------| | semantic_code_search | Find code by meaning — regex search with language filtering | Read-only | | symbol_lookup | Look up symbol definitions (fn, struct, trait, class, def) | Read-only | | find_references | Find all references to a symbol across the codebase | Read-only | | get_call_graph | Get callers and callees for a function | Read-only | | get_dependency_graph | Parse Cargo.toml/package.json for dependency tree | Read-only | | get_codeowners | Get CODEOWNERS for a file or directory | Read-only | | build_context_pack | Gather related files, dependencies, and tests | Read-only | | explain_symbol | Definition, signature, doc comments, usage count, location | Read-only |

Verified Output

Tested against the mcp-a2a codebase:

> semantic_code_search(query: "resolve_card", language: "rust", limit: 5)

{ "query": "resolve_card", "count": 5, "results": [
  { "file": "src/store.rs", "line": 30, "text": "pub async fn resolve_card(&self, base_url: &str) -> Result<A..." },
  { "file": "src/server.rs", "line": 64, "text": "match self.store.resolve_card(&i.base_url).await {" }
]}

> symbol_lookup(symbol: "A2aStore", kind: "struct")

{ "symbol": "A2aStore", "kind": "struct", "definitions": [
  { "file": "src/store.rs", "line": 10 }
], "count": 1 }

> get_dependency_graph(path: ".")

{ "path": ".", "count": 15, "dependencies": [
  { "name": "adk-mcp-sdk", "version": "0.1.0" },
  { "name": "rmcp", "version": "1.7" },
  { "name": "tokio", "version": "1.43" },
  { "name": "serde", "version": "1.0" },
  { "name": "reqwest", "version": "0.12" }
]}

> find_references(symbol: "send_message")

{ "symbol": "send_message", "count": 20, "references": [...] }

> explain_symbol(symbol: "AgentCard")

{ "symbol": "AgentCard", "definition_count": 7, "reference_count": 20 }

Installation

Build from source

git clone https://github.com/zavora-ai/mcp-code-search
cd mcp-code-search
cargo build --release

The binary is at target/release/mcp-code-search.

Configuration

export CODE_SEARCH_WORKSPACE=/path/to/your/project

If not set, defaults to the current working directory.

Claude Desktop

{
  "mcpServers": {
    "code-search": {
      "command": "/path/to/mcp-code-search",
      "env": { "CODE_SEARCH_WORKSPACE": "/path/to/project" }
    }
  }
}

Kiro

{
  "mcpServers": {
    "code-search": {
      "command": "/path/to/mcp-code-search",
      "env": { "CODE_SEARCH_WORKSPACE": "/path/to/project" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "code-search": {
      "command": "/path/to/mcp-code-search",
      "env": { "CODE_SEARCH_WORKSPACE": "/path/to/project" }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "code-search": {
      "command": "/path/to/mcp-code-search",
      "env": { "CODE_SEARCH_WORKSPACE": "/path/to/project" }
    }
  }
}

Supported Languages

| Language | Extensions | Symbol Patterns | |----------|-----------|-----------------| | Rust | .rs | fn, struct, trait, enum, type, const | | TypeScript | .ts, .tsx | function, class, interface, type, const | | Python | .py | def, class | | Go | .go | func, type, const | | Java | .java | class, interface | | JavaScript | .js | function, class, const |

MCP Server Manifest

server_id = "mcp_code_search"
display_name = "Code Search MCP"
version = "1.0.0"
domain = "developer"
risk_level = "low"
writes_allowed = "none"
transports = ["stdio"]
governance_gates = []

Contributors

|
_{James Karanja Maina} | |:---:|

License

Apache-2.0 — see LICENSE for details.

Part of the ADK-Rust Enterprise MCP server ecosystem.

MCP Servers