Fast semantic code sea 8000 rch 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.
Install:
npm install -g @nendo/tree-sitter-mcpSearch for code:
tree-sitter-mcp search "handleRequest" --type functionAnalyze code quality:
tree-sitter-mcp analyze --analysis-types quality deadcode structureFind syntax errors:
tree-sitter-mcp errors --output textSetup with Claude Desktop:
tree-sitter-mcp setup --autoOr 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"
}
}
}- 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
JavaScript, TypeScript, Python, Go, Rust, Java, C/C++, Ruby, C#, PHP, Kotlin, Scala, Elixir
Config files: JSON, YAML, TOML, .env
Search for code elements:
tree-sitter-mcp search "DatabaseManager" --exact
tree-sitter-mcp search "handle.*Request" --type function methodFind usage of identifiers:
tree-sitter-mcp find-usage "UserService" --exact
tree-sitter-mcp find-usage "API_KEY" --case-sensitiveAnalyze code quality:
tree-sitter-mcp analyze --analysis-types quality structure deadcode
tree-sitter-mcp analyze src/components --analysis-types qualityFind syntax errors:
tree-sitter-mcp errors --output text
tree-sitter-mcp errors src/components --max-results 10Setup MCP integration:
tree-sitter-mcp setup --auto
tree-sitter-mcp setup # Manual setup instructionsWhen used as an MCP server, provides these tools for AI assistants:
search_code- Search for functions, classes, variables by namefind_usage- Find all usages of identifiers across the projectanalyze_code- Comprehensive code quality and structure analysischeck_errors- Find actionable syntax errors with detailed context
See the full documentation for detailed API reference.
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)
We welcome contributions! Please see our Contributing Guide for details.
GPL-3.0
Built with Tree-Sitter and the Model Context Protocol.