Source Tree Generator

🚀 MCP ソースコードツリーサーバー

指定されたディレクトリ内のファイルツリーを生成するMCPサーバーです。 .で始まるディレクトリや.gitignoreで指定された条件に該当する特定のファイルやディレクトリは除外されます。

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 Desktopでの設定

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

{
    "mcpServers": {
        "src-tree": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-src-tree",  # あなたのプロジェクトディレクトリの絶対パスに置き換える
                "run",
                "tree.py"
            ]
        }
    }
}

💻 使用例

基本的な使用法

指示する際には、srcの上位のルートディレクトリを指定してください。 ルートディレクトリに.gitignoreファイルが存在し、以下の内容が含まれていると仮定します。

__pycache__
node_modules/
*.log

ユーザーが「/GitHub/xxx/ のソースコードツリーを確認してください」と指示すると、Claudeは次のように応答します。

はい、ソースコードツリーを確認します。
プロジェクトの構造を確認しました。以下がその構成です。
src/
└── xxxx/
    ├── __init__.py
    ├── converter.py
    ├── html_converter.py
    ├── image_processor.py
    ├── toc_analyzer.py
    └── utils.py

これにより、Claudeはプロジェクト構造をすばやく把握することができます。