Tree-Sitter MCP

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 ~/.config/claude-desktop/claude_desktop_config.json:

{
  "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)

Contributing

We welcome contributions! Please see our Contributing Guide for details.

• Report bugs
• Request features
• Submit pull requests

License

GPL-3.0

Acknowledgments

Built with Tree-Sitter and the Model Context Protocol.