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.

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"
    }
  }
}

• 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 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

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.

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.

• Report bugs
• Request features
• Submit pull requests

GPL-3.0

Built with Tree-Sitter and the Model Context Protocol.