Code Tree (Thinky Miner)

代码树

停止向您的AI代理提供整个文件。

快速开始

先决条件： 安装 紫外线 如果你没有(curl -LsSf https://astral.sh/uv/install.sh | sh).

然后 cd 进入任何项目并运行：

claude mcp add codetree -- uvx --from mcp-server-codetree codetree --root .

就是这样 . 意思是“这个项目”。您的代理现在对结构化代码有了理解。

不使用克劳德代码？看 编辑器设置 适用于Cursor、VS Code、Windsurf和Claude Desktop。

之前/之后

在代码树--agent读取原始文件之前：

$ cat calculator.py
import math
from typing import Optional

class Calculator:
    """A scientific calculator with memory."""

    def __init__(self):
        self.memory = 0
        self.history = []

    def add(self, a: float, b: float) -> float:
        """Add two numbers."""
        result = a + b
        self.history.append(('add', a, b, result))
        return result

    def divide(self, a: float, b: float) -> Optional[float]:
        """Divide a by b, returns None on zero division."""
        if b == 0:
            return None
        result = a / b
        self.history.append(('divide', a, b, result))
        return result

    # ... 200 more lines of methods ...

消耗的令牌：完整文件约2000+

在代码树--agent请求骨架之后：

class Calculator → line 4
  "A scientific calculator with memory."
  def __init__(self) (in Calculator) → line 7
  def add(self, a: float, b: float) (in Calculator) → line 11
    "Add two numbers."
  def divide(self, a: float, b: float) (in Calculator) → line 17
    "Divide a by b, returns None on zero division."
  def sqrt(self, x: float) (in Calculator) → line 24
    "Square root using math.sqrt."

消耗的代币：~80。减少了25倍。

代理可以看到每个类、方法和文档字符串（带行号），而无需读取单个函数体。当它需要完整的来源时 divide，它叫 get_symbol("calculator.py", "divide") 只有这6条线。

23工具

了解结构

导航关系

分析质量

检查和搜索

入职培训与图表

更改和数据流

可视化和历史

get_file_skeleton, get_skeletons，以及 search_symbols 接受 format="compact" 甚至更少的代币。

支持的语言

编辑器设置

这 --root flag告诉代码树要分析哪个项目。使用 . 当前目录或完整路径。

克劳德代码

cd 进入你的项目，然后：

claude mcp add codetree -- uvx --from mcp-server-codetree codetree --root .

光标

添加 .cursor/mcp.json 在您的项目中：

{
  "mcpServers": {
    "codetree": {
      "command": "uvx",
      "args": ["--from", "mcp-server-codetree", "codetree", "--root", "${workspaceFolder}"]
    }
  }
}

VS代码（副本）

添加 .vscode/mcp.json 在您的项目中：

{
  "servers": {
    "codetree": {
      "command": "uvx",
      "args": ["--from", "mcp-server-codetree", "codetree", "--root", "${workspaceFolder}"]
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "codetree": {
      "command": "uvx",
      "args": ["--from", "mcp-server-codetree", "codetree", "--root", "${workspaceFolder}"]
    }
  }
}

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "codetree": {
      "command": "uvx",
      "args": ["--from", "mcp-server-codetree", "codetree", "--root", "/path/to/your/project"]
    }
  }
}

Claude Desktop不支持 ${workspaceFolder}，所以在这里使用完整路径。

为什么是代码树？

建筑

Agent (Claude, Copilot, Cursor, etc.)
    │ MCP (stdio)
    ▼
codetree server (FastMCP)
    │
    ├── Indexer → LanguagePlugin → tree-sitter → structured results
    │   Cache (.codetree/index.json, mtime-based)
    │
    └── Graph Layer → SQLite (.codetree/graph.db)
        Persistent symbols + edges, incremental updates
        Change impact, dataflow, taint analysis

添加语言

1. pip install tree-sitter-LANG 并添加到 pyproject.toml
2. 复制 src/codetree/languages/_template.py 到 languages/yourlang.py
3. 实现抽象方法
4. 在中注册扩展名 registry.py
5. 添加测试

发展

git clone https://github.com/ThinkyMiner/codeTree.git
cd codeTree
python -m venv .venv
source .venv/bin/activate
pip install -e .
pip install pytest

# Run all tests (~1058 tests, ~35s)
pytest

# Run a single test file
pytest tests/languages/test_python.py -v

贡献

欢迎投稿！看 贡献.md 有关设置说明和指南。