Tree-sitter Code Analysis

Intelligent code analysis via AST parsing with tree-sitter.

When to Use

•Understanding code structure across multiple languages
•Extracting function/class definitions
•Finding code patterns with tree-sitter queries
•Analyzing code complexity
•Symbol extraction and dependency analysis

Setup

MCP server configured in ~/.mcp.json:

json

{
  "tree-sitter": {
    "command": "python3",
    "args": ["-m", "mcp_server_tree_sitter.server"],
    "cwd": "/Users/alice/mcp-server-tree-sitter"
  }
}

Usage Pattern

1. Register a Project First

code

register_project_tool(path="/path/to/project", name="my-project")

2. Explore Files

code

list_files(project="my-project", pattern="**/*.py")
get_file(project="my-project", path="src/main.py")

3. Analyze Structure

code

get_ast(project="my-project", path="src/main.py", max_depth=3)
get_symbols(project="my-project", path="src/main.py")

4. Search with Queries

code

find_text(project="my-project", pattern="function", file_pattern="**/*.py")
run_query(
  project="my-project",
  query='(function_definition name: (identifier) @function.name)',
  language="python"
)

5. Complexity Analysis

code

analyze_complexity(project="my-project", path="src/main.py")

Available Tools

•Project: register_project_tool, list_projects_tool, remove_project_tool
•Language: list_languages, check_language_available
•Files: list_files, get_file, get_file_metadata
•AST: get_ast, get_node_at_position
•Search: find_text, run_query
•Symbols: get_symbols, find_usage
•Analysis: analyze_project, get_dependencies, analyze_complexity
•Queries: get_query_template_tool, build_query, adapt_query
•Similar Code: find_similar_code

Supported Languages

Python, JavaScript, TypeScript, Go, Rust, C, C++, Swift, Java, Kotlin, Julia, APL, and many more via tree-sitter-language-pack.

Scientific Skill Interleaving

This skill connects to the K-Dense-AI/claude-scientific-skills ecosystem:

Tree Structures

•
etetoolkit [○] via bicomodule
- •Tree parsing and traversal

Bibliography References

•graph-theory: 38 citations in bib.duckdb

SDF Interleaving

This skill connects to Software Design for Flexibility (Hanson & Sussman, 2021):

Primary Chapter: 6. Layering

Concepts: layered data, metadata, provenance, units

GF(3) Balanced Triad

code

tree-sitter (○) + SDF.Ch6 (+) + [balancer] (−) = 0

Skill Trit: 0 (ERGODIC - coordination)

Secondary Chapters

•Ch4: Pattern Matching
•Ch2: Domain-Specific Languages

Connection Pattern

Layering adds metadata. This skill tracks provenance or annotations.

Cat# Integration

This skill maps to Cat# = Comod(P) as a bicomodule in the equipment structure:

code

Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826

GF(3) Naturality

The skill participates in triads satisfying:

code

(-1) + (0) + (+1) ≡ 0 (mod 3)

This ensures compositional coherence in the Cat# equipment structure.