treesitter-mcp

# Tree-sitter MCP Server An MCP server that uses Tree-sitter to parse and analyze code. ## What it does - Parse files and get their AST - Extract functions and variables - Build call graphs - Find where functions/variables are used - Run custom Tree-sitter queries - List imports/includes - Extract source code for specific line/column ranges ## Install Requires Python 3.10+. ```bash # Install directly uv pip install treesitter-mcp # Or clone and install git clone https://github.com/pwno-io/treesitter-mcp.git cd treesitter-mcp uv pip install -e . ``` This installs both `treesitter-mcp` and `ts-cli` entry points. Or run without installing: ```bash uvx treesitter-mcp ``` ## Running ### As an MCP server (default) For use with Claude Desktop or other MCP clients: ```bash treesitter-mcp ``` See `docs/MCP_USAGE.md` for how to configure. ### Standalone CLI (ts-cli) Run analysis directly from the terminal: ```bash ts-cli path/to/file.py ts-cli path/to/file.py --ast --max-depth 2 ts-cli path/to/file.py --find-function main --include-source ts-cli --supported-languages ``` Use `--output-file` to write results to JSON files instead of stdout. ### HTTP mode For testing or manual use: ```bash treesitter-mcp --http --port 8000 --host 127.0.0.1 ``` ### Limiting tools Only expose certain tools with `--tools`: ```bash treesitter-mcp --http --port 8000 --tools treesitter_analyze_file,treesitter_get_ast ``` Or via URL query param: `http://127.0.0.1:8000?tools=treesitter_analyze_file,treesitter_get_ast` Tools available: - `treesitter_analyze_file` - Basic analysis - `treesitter_get_ast` - Full AST - `treesitter_get_call_graph` - Function calls - `treesitter_find_function` - Find function definitions - `treesitter_find_variable` - Find variables - `treesitter_get_source_for_range` - Extract source code for a range - `treesitter_get_supported_languages` - What's supported - `treesitter_get_node_at_point` - AST node at a line/column - `treesitter_get_node_for_ra…