Tree-sitter MCP Server

MCPOfficialOpen SourceMIT63.8

by wrale • Search & Retrieval

An MCP server that provides structure-aware code analysis using tree-sitter to give AI assistants intelligent, context-managed access to codebases.

Example Use Cases

1
Extract and traverse ASTs or symbols (functions, classes) from a repository to perform code understanding and generation tasks.
2
Search codebases using text search or tree-sitter queries to find patterns, usages, or potential refactor targets.
3
Fetch bounded, context-appropriate slices of files (lines, AST depth) with caching and project persistence to stay within model context windows.

Description

This server implements the Model Context Protocol (MCP) to expose ASTs, symbol extraction, search, and query capabilities using tree-sitter parsers. It supports many languages, efficient cursor-based traversal, parse-tree caching, and project state persistence for repeated analysis. Integrations and tools are provided to register projects, fetch files or line ranges, run tree-sitter queries, and analyze complexity or dependencies. Designed for use with Claude Desktop (reference) but reusable directly as a Python library or standalone server.

Capabilities(31 total)

Tools (26)

configure

Configure the server. Args: config_path: Path to YAML config file cache_enabled: Whether to enable parse tree caching max_file_size_mb: Maximum file size in MB log_level: Logging level (DEBUG, INFO, WARNING, ERROR) Returns: Current configuration

config_path:anycache_enabled:anymax_file_size_mb:anylog_level:any

register_project_tool

Register a project directory for code exploration. Args: path: Path to the project directory name: Optional name for the project (defaults to directory name) description: Optional description of the project Returns: Project information

path:string*name:anydescription:any

list_projects_tool

List all registered projects. Returns: List of project information

remove_project_tool

Remove a registered project. Args: name: Project name Returns: Success message

name:string*

list_languages

List available languages. Returns: Information about available languages

Prompts (5)

code_review

Create a prompt for reviewing a code file

projectfile_path

explain_code

Create a prompt for explaining a code file

projectfile_pathfocus

explain_tree_sitter_query

Create a prompt explaining tree-sitter query syntax

suggest_improvements

Create a prompt for suggesting code improvements

projectfile_path

project_overview

Create a prompt for a project overview analysis

project

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

MODERATE

Can modify files, state, or send data externally

Trust Score

C54/100

7/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities26 Tools / 5 Prompts / 0 Resources

Ownerwrale

CategorySearch & Retrieval

DependenciesStandalone

Set Your Username