Tree-Sitter MCP

npm version License: GPL v3 Node.js

Fast semantic code search and analysis for common programming languages. Search for functions and classes, trace code usage, and analyze code quality across your entire project.

Works as both a standalone CLI tool and an MCP server for AI tools like Claude Code.

Getting Started

Install:

npm install -g @nendo/tree-sitter-mcp

Search for code:

tree-sitter-mcp search "handleRequest" --type function

Analyze code quality:

tree-sitter-mcp analyze --analysis-types quality deadcode structure

Find syntax errors:

tree-sitter-mcp errors --output text

Setup with Claude Desktop:

tree-sitter-mcp setup --auto

Or configure manually by adding to

{ "mcpServers": { "tree-sitter-mcp": { "command": "npx", "args": ["@nendo/tree-sitter-mcp", "--mcp"], "cwd": "/path/to/your/project" } } }

Features

Semantic search - Find functions, classes, and variables by name across 15+ languages
Usage tracing - See where code is used before making changes
Quality analysis - Detect complex functions, dead code, and architectural issues
Fast results - Sub-100ms searches by parsing code structure, not scanning text
No configuration - Works immediately on any project

Supported Languages

JavaScript, TypeScript, Python, Go, Rust, Java, C/C++, Ruby, C#, PHP, Kotlin, Scala, Elixir

Config files: JSON, YAML, TOML, .env

CLI Usage

Search for code elements:

tree-sitter-mcp search "DatabaseManager" --exact tree-sitter-mcp search "handle.*Request" --type function method

Find usage of identifiers:

tree-sitter-mcp find-usage "UserService" --exact tree-sitter-mcp find-usage "API_KEY" --case-sensitive

Analyze code quality:

tree-sitter-mcp analyze --analysis-types quality structure deadcode tree-sitter-mcp analyze src/components --analysis-types quality

Find syntax errors:

tree-sitter-mcp errors --output text tree-sitter-mcp errors src/components --max-results 10

Setup MCP integration:

tree-sitter-mcp setup --auto tree-sitter-mcp setup # Manual setup instructions

MCP Tools

When used as an MCP server, provides these tools for AI assistants:

search_code - Search for functions, classes, variables by name
find_usage - Find all usages of identifiers across the project
analyze_code - Comprehensive code quality and structure analysis
check_errors - Find actionable syntax errors with detailed context

See the full documentation for detailed API reference.

Installation Requirements

This package includes native components requiring build tools:

Windows: Visual Studio Build Tools or npm install --global windows-build-tools
macOS: Xcode Command Line Tools (xcode-select --install)
Linux: sudo apt-get install build-essential (Ubuntu/Debian)