MCP Source Tree Server

这是一个MCP服务器，用于生成指定目录下的文件树。
它会根据以.开头的目录或.gitignore中记载的条件来排除特定的文件或目录。
通过将其集成到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