treesitter-mcp 0.1.3

MCP server for code analysis using Tree-sitter

Tree-sitter MCP Server

A Model Context Protocol (MCP) server for code analysis using Tree-sitter. This tool provides capabilities to parse code, extract symbols, generate call graphs, find usages, and run custom queries against C, C++, and Python code.

Features

• AST Retrieval: Get the full Abstract Syntax Tree (AST) of a file.
• Symbol Extraction: Find function and variable definitions.
• Call Graph: Generate a call graph for C/C++ functions.
• Tree-sitter Queries: Run custom S-expression queries against your code.
• Usage Finder: Find usages of functions and variables.
• Dependency Extraction: List file dependencies (includes/imports).
• Multi-Language Support: Currently supports C, C++, and Python.

Installation

Prerequisites

• Python 3.10+
• pip

Setup

1. Clone the repository.
2. Install the package:

   # Using uv (recommended)
   uv pip install -e .
   
   # Or using pip
   pip install -e .
   

This will install the treesitter-mcp command-line tool.

You can also run it directly without installation using uvx:

uvx treesitter-mcp

Usage

MCP Server (Default)

By default, treesitter-mcp runs as an MCP server in stdio mode:

treesitter-mcp

This is perfect for integrating with MCP clients like Claude Desktop. See docs/MCP_USAGE.md for configuration instructions.

HTTP Mode

To run the server in HTTP mode for testing or development:

treesitter-mcp --http --port 8000 --host 127.0.0.1

Example with uvx

# Run in stdio mode (default)
uvx treesitter-mcp

# Run in HTTP mode
uvx treesitter-mcp --http --port 8000

Configure your MCP client (e.g., Claude Desktop) to use this server. See `docs/MCP_USAGE.md` for detailed configuration instructions.

## Supported Languages

-   **C**: Full support (Symbols, Call Graph, Queries, Usage).
-   **C++**: Full support.
-   **Python**: Full support.

## Documentation

See the `docs/` directory for more details:
-   [API Reference](docs/API.md)
-   [MCP Server Usage](docs/MCP_USAGE.md)
-   [Architecture](docs/ARCHITECTURE.md)