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:

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

Search for code:

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

Analyze code quality:

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

Find syntax errors:

`bash
tree-sitter-mcp errors --output text
`

Setup with Claude Desktop:

`bash
tree-sitter-mcp setup --auto
`

Or configure manually by adding to ~/.config/claude-desktop/claude_desktop_config.json:

`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:

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

Find usage of identifiers:

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

Analyze code quality:

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

Find syntax errors:

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

Setup MCP integration:

`bash
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.