github-codemunch-mcp

Token-efficient MCP server for GitHub source code exploration via tree-sitter AST parsing.

Overview

github-codemunch-mcp pre-indexes repository source code using tree-sitter AST parsing, extracting a structured catalog of every symbol (function, class, method, constant, type). Each symbol stores only its signature + one-line summary, with the ability to retrieve full source on demand.

Token Savings

Quick Start

Installation

pip install github-codemunch-mcp

Configure MCP

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "github-codemunch": {
      "command": "github-codemunch-mcp",
      "env": {
        "GITHUB_TOKEN": "your_github_token",
        "ANTHROPIC_API_KEY": "your_anthropic_key"
      }
    }
  }
}

Usage

1. Index a repository:

   index_repo: { "url": "owner/repo" }
   

2. Search for symbols:

   search_symbols: { "repo": "owner/repo", "query": "authenticate" }
   

3. Get file outline:

   get_file_outline: { "repo": "owner/repo", "file_path": "src/main.py" }
   

4. Read symbol source:

   get_symbol: { "repo": "owner/repo", "symbol_id": "src-main-py::MyClass.login" }
   

Supported Languages

• Python (.py)
• JavaScript (.js, .jsx)
• TypeScript (.ts, .tsx)
• Go (.go)
• Rust (.rs)
• Java (.java)

Tools

Environment Variables

License

MIT