Source Tree Generator

🚀 MCP Source Code Tree Server

Generate an MCP server for the file tree in a specified directory. Directories starting with . or files/directories that meet the conditions specified in .gitignore will be excluded. After integrating with Claude, you can quickly confirm the project structure and determine the files that need to be edited.

✨ Features

• Retrieve the file tree in a specified directory and return it in JSON format.
• Exclude files/directories based on the conditions in .gitignore.
• Represent the directory structure in a hierarchical JSON format.

📦 Installation

Prerequisites

• Python version 3.10 or higher.
• uv installed.

Installation Steps

# Install uv
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/mcp-src-tree
# Install dependent libraries
$ uv sync

💻 Configuration in Claude Desktop

Add the following configuration to claude_desktop_config.json:

{
    "mcpServers": {
        "src-tree": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-src-tree",  # Replace with the absolute path of your project directory
                "run",
                "tree.py"
            ]
        }
    }
}

💻 Usage Examples

When giving instructions, please specify the root directory above src. Assume that the .gitignore file exists in the root directory and contains the following content:

__pycache__
node_modules/
*.log

When the user instructs "Please confirm the source code tree of /GitHub/xxx/", Claude will respond as follows:

Yes, let me confirm the source code tree.
I have confirmed the project structure, and here is its composition:
src/
└── xxxx/
    ├── __init__.py
    ├── converter.py
    ├── html_converter.py
    ├── image_processor.py
    ├── toc_analyzer.py
    └── utils.py

In this way, Claude can quickly understand the project structure.