treesitter-mcp 2.0

MCP server for code analysis using Tree-sitter

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

Install

Requires Python 3.10+.

# 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 .

Or run without installing:

uvx treesitter-mcp

Running

As an MCP server (default)

For use with Claude Desktop or other MCP clients:

treesitter-mcp

See docs/MCP_USAGE.md for how to configure.

HTTP mode

For testing or manual use:

treesitter-mcp --http --port 8000 --host 127.0.0.1

Limiting tools

Only expose certain tools with --tools:

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_supported_languages - What's supported
• treesitter_get_node_at_point - AST node at a line/column
• treesitter_get_node_for_range - AST node for a range
• treesitter_cursor_walk - Walk tree with context
• treesitter_run_query - Custom Tree-sitter queries
• treesitter_find_usage - Find symbol usages
• treesitter_get_dependencies - Extract imports/includes

If you don't specify --tools, everything is exposed.

Language support

Language	analyze_file	get_ast	get_call_graph	find_function	find_variable	find_usage	get_dependencies
C	✅	✅	✅	✅	✅	✅	✅
C++	✅	✅	✅	✅	✅	✅	✅
Python	✅	✅	✅	✅	✅	✅	✅
JavaScript	✅	✅	✅	✅	✅	✅	✅
TypeScript	✅	✅	✅	✅	✅	✅	✅
Go	✅	✅	✅	✅	✅	✅	✅
Java	✅	✅	✅	✅	✅	✅	✅
PHP	✅	✅	✅	✅	✅	✅	✅
Rust	✅	✅	✅	✅	✅	✅	✅
Ruby	✅	✅	✅	✅	✅	✅	✅

File extensions

Language	Extensions
C	.c
C++	.cpp, .cc, .cxx, .h, .hpp
Python	.py
JavaScript	.js, .jsx, .mjs, .cjs
TypeScript	.ts, .tsx, .cts, .mts
Go	.go
Java	.java
PHP	.php, .phtml
Rust	.rs
Ruby	.rb

Docs

• API Reference
• MCP Server Usage
• Architecture