MCP Source Tree Server

指定されたディレクトリ配下のファイルツリーを生成するMCPサーバーです。 .で始まるディレクトリや.gitignore に記載された条件に従って、特定のファイルやディレクトリを除外します。 Claudeに組み込むことで、Claudeがプロジェクトの構造を素早く確認でき、Claudeが編集すべきファイルを特定するのに役立ちます。

機能

指定されたディレクトリ配下のファイルツリーをJSON形式で取得
.gitignore の条件に従ってファイル/ディレクトリを除外
ディレクトリ構造を階層的なJSONで表現

セットアップ

必要条件

Python 3.10以上
uv

インストール

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

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

Claude for Desktopでの設定

claude_desktop_config.json に以下の設定を追加してください：

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

Claudeでの使用例

指示するのはsrcの一つ上のルートディレクトリを指定してください。 .gitignore を考慮する場合、ルートディレクトリ直下に .gitignore が存在することが前提です。 /Users/xxx/GitHub/xxx/ のソースツリーを確認してください のように指示すると動作します

以下のように応答します

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

これにより、Claudeが素早くプロジェクトの構造を確認できます。

ファイル除外

.で始まるディレクトリは自動的に除外されます。 .gitignore に記載されているパターンに合致するファイルやディレクトリは、ツリーから自動的に除外されます。例えば、以下のような .gitignore の設定が有効です：

__pycache__/
node_modules/
*.log

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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
417
14
TypeScript
MIT License
MCP Source Relation Server
owayo
A
security
A
license
A
quality
Analyzes source code dependencies across multiple programming languages in the specified directory to identify file relationships, assisting in dependency management and project structure understanding.
Last updated -
1
Python
MIT License
SourceSage MCP
Sunwood-ai-labs
A
security
F
license
A
quality
A TypeScript-based server that visualizes project directory structures in Markdown format, automatically documenting file contents with syntax highlighting and supporting customizable exclusion patterns.
Last updated -
1
248
2
TypeScript
File Rank MCP Server
admica
-
security
A
license
-
quality
A tool that helps rank codebase files by importance (1-10 scale), track file dependencies, and provide summaries, all accessible through a simple JSON-based interface.
Last updated -
2
TypeScript
GPL 3.0

View all related MCP servers

MCP Source Tree Server