MCP Source Tree Server

It is an MCP server that generates a file tree under a specified directory. It excludes certain files and directories, such as directories starting with . or conditions in .gitignore . By incorporating it into Claude, it helps Claude to quickly see the structure of the project and identify the files that Claude should edit.

function

Gets the file tree under the specified directory in JSON format.
Exclude files/directories according to .gitignore conditions
Represents the directory structure as hierarchical JSON

set up

Prerequisites

Python 3.10 or later
uv

install

# uvのインストール
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/mcp-src-tree
# ライブラリのインストール
$ uv sync

Claude for Desktop Settings

Add the following to claude_desktop_config.json :

{
    "mcpServers": {
        "src-tree": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-src-tree",  # このプロジェクトディレクトリの絶対パスに書き換えてください
                "run",
                "tree.py"
            ]
        }
    }
}

Claude usage example

Please specify the root directory one level above src. When considering .gitignore , it is assumed that .gitignore exists directly under the root directory. It will work if you specify something like /Users/xxx/GitHub/xxx/ のソースツリーを確認してください

It responds as follows:

はい、ソースツリーを確認させていただきます。
プロジェクトの構造を確認しました。以下のような構成になっています：
src/
└── xxxx/
    ├── __init__.py
    ├── converter.py
    ├── html_converter.py
    ├── image_processor.py
    ├── toc_analyzer.py
    └── utils.py

This allows Claude to quickly see the project structure.

File Exclusions

Directories beginning with . are automatically excluded. Files and directories that match a pattern in .gitignore are automatically excluded from the tree. For example, the following .gitignore configuration is valid:

__pycache__/
node_modules/
*.log

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

get_src_tree

Generates a JSON file tree from a specified directory's 'src' folder, adhering to '.gitignore' rules, allowing for quick project structure review in Claude.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-neurolora
aindreyway
A
security
A
license
A
quality
Provides tools for collecting and documenting code from directories.
Last updated -
4
81
12
TypeScript
MIT License
Figma MCP Server
moonray
A
security
A
license
A
quality
Facilitates the analysis of Figma file structures by extracting node hierarchies, accessible via REST API or MCP protocol.
Last updated -
1
2
TypeScript
MIT License
MCP Git Repo Browser
razorback16
A
security
A
license
A
quality
A Node.js server that allows browsing Git repositories through MCP, providing tools to view directory structures and read important files from repositories.
Last updated -
2
JavaScript
MIT License
Git File Forensics MCP
davidorex
A
security
A
license
A
quality
Provides deep git file-level forensics tools to analyze detailed file histories, changes, and patterns within git repositories, focusing on individual file analysis rather than repository-wide operations.
Last updated -
4
JavaScript
Apache 2.0

View all related MCP servers

MCP Source Tree Server