MCP Server Tree Sitter

🚀 MCP 樹結構（Tree）指南

本指南聚焦於 MCP 樹結構（Tree），為你提供安裝、配置、使用等方面的詳細信息，助你快速上手並高效運用該工具。

🚀 快速開始

在使用 MCP 樹結構（Tree）前，你需要完成安裝與配置。以下是快速上手的步驟：

from mcp_tree import configure, get_container

# 配置文件路徑或直接傳遞參數
configure(config_path="path/to/config.yaml")

container = get_container()

📦 安裝指南

本地安裝

pip install mcp-tree

虛擬環境使用

python -m venv myenv
source myenv/bin/activate  # 在 Windows 上使用 `myenv\Scripts\activate`
pip install mcp-tree

💻 使用示例

基礎用法

from mcp_tree import configure, get_container

# 配置文件路徑或直接傳遞參數
configure(config_path="path/to/config.yaml")

container = get_container()

📚 詳細文檔

配置示例

cache:
  enabled: true                # 啟用/禁用緩存（默認：true）
  max_size_mb: 100            # 最大緩存大小（MB）（默認：100）
  ttl_seconds: 300            # 緩存條目過期時間（秒）（默認：300）

security:
  max_file_size_mb: 5         # 最大處理文件大小（MB）（默認：5）
  excluded_dirs:              # 處理中要排除的目錄
    - .git
    - node_modules
    - __pycache__
  allowed_extensions:          # 可選允許的文件擴展名
    - py
    - js

language:
  default_max_depth: 5        # 默認 AST 遍歷最大深度（默認：5）
  preferred_languages:         # 加速啟動預加載語言列表
    - python

環境變量配置

export MCP_TS_CACHE_MAX_SIZE_MB=256
export MCP_TS_LOG_LEVEL=DEBUG
export MCP_TS_CONFIG_PATH=/path/to/config.yaml

日誌設置

日誌級別：

• DEBUG
• INFO
• WARNING
• ERROR

默認路徑：~/.config/tree-sitter/config.yaml

資源與工具

提供的資源

1. 項目相關資源：

   • project://{project}/files：列出項目中所有文件
   • project://{project}/files/{pattern}：按模式匹配列出文件
   • project://{project}/file/{path}：獲取指定路徑下的文件內容
   • project://{project}/ast/{path}：獲取文件的 AST 結構

2. 語言相關資源：

   • language：預加載常用語言以提升性能

提供的工具

1. 項目管理工具：

   • register_project_tool
   • list_projects_tool
   • remove_project_tool

2. 文件操作工具：

   • list_files
   • get_file
   • get_file_metadata

3. AST 分析工具：

   • get_ast
   • get_node_at_position

4. 代碼搜索與查詢：

   • find_text
   • run_query
   • build_query
   • adapt_query

5. 符號提取與分析：

   • get_symbols
   • find_usage

提示語

1. 代碼審查：用於生成代碼審查報告
2. 錯誤定位：幫助快速定位代碼問題
3. 依賴注入：管理項目中的依賴關係

更多詳細信息請參考官方文檔。