Source Tree Generator

🚀 MCP 源代碼樹服務器

MCP 源代碼樹服務器可基於指定目錄下的文件生成文件樹。它會自動排除以 . 開頭的目錄，以及 .gitignore 文件中指定的特定文件或目錄。與 Claude 集成後，能讓你快速確認項目結構，精準定位需要編輯的文件。

🚀 快速開始

MCP 源代碼樹服務器能為你提供指定目錄下的文件樹結構，與 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 可以快速瞭解項目結構。