MCP 源树服务器

这是一个在指定目录下生成文件树的 MCP 服务器。根据以开头的目录排除特定的文件或目录.或.gitignore中列出的条件。与 Claude 集成可以让 Claude 快速查看项目结构并帮助他确定要编辑的文件。

功能

以 JSON 格式获取指定目录下的文件树。
根据.gitignore条件排除文件/目录
将目录结构表示为分层 JSON

Related MCP server: MCP Source Relation Server

设置

先决条件

Python 3.10 或更高版本
紫外线

安装

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

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

Claude 用于桌面设置

将以下内容添加到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 能够快速了解项目结构。