AI 에이전트에게 전체 파일을 입력하지 마세요.

codetree 는 tree-sitter 를 통해 코딩 에이전트에 구조화된 코드 이해를 제공하는 MCP 서버입니다. 이를 통해 에이전트는 수천 줄을 읽는 대신 정확한 질문을 할 수 있습니다. 23 개의 도구, 10 개 언어, ~1 초 시작 시간. 벡터 DB 없음, 임베딩 모델 없음, 설정 없음.

필수 조건: uv 를 설치하지 않은 경우 ( curl -LsSf https://astral.sh/uv/install.sh | sh ).

그런 다음 프로젝트의 어느 폴더로 이동하여 실행하세요:

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

이제 끝입니다. . 은 "이 프로젝트"를 의미합니다. 이제 에이전트는 구조화된 코드 이해를 갖게 되었습니다.

Claude Code 를 사용하지 않으신가요? Cursor, VS Code, Windsurf, Claude Desktop 에 대한 편집기 설정을 확인하세요.

$ cat calculator.py
import math
from typing import Optional
...

토큰 소모량: 전체 파일 ~2,000+ 토큰

class Calculator → line 4
"A scientific calculator with memory."
def __init__(self) (in Calculator) → line 7
...

토큰 소모량: ~80 토큰. 25 배 감소.

에이전트는 함수 본문 하나도 읽지 않고 모든 클래스, 메서드, 문서 문자열을 — 줄 번호와 함께 — 볼 수 있습니다. divide 의 전체 소스를 필요로 할 때, get_symbol("calculator.py", "divide") 를 호출하여 해당 6 줄만 얻습니다.

get_file_skeleton, get_skeletons, 그리고 search_symbols

acceptformat="compact"

더 적은 토큰을 위해.

--root

플ラグ은 codetree 가 분석할 프로젝트를 지정합니다. 현재 디렉토리를 사용하려면 . 을, 전체 경로를 사용하려면 해당 경로를 입력하세요.

프로젝트 디렉토리로 이동한 후 다음 명령어를 실행하세요:

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

프로젝트의 .cursor/mcp.json 에 추가합니다:

{
"mcpServers": {
"codetree": {
...

프로젝트의 .vscode/mcp.json 에 추가합니다:

{
"servers": {
"codetree": {
...

프로젝트의 ~/.codeium/windsurf/mcp_config.json 에 추가합니다:

{
"mcpServers": {
"codetree": {
...

macOS 의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows 의 경우 %APPDATA%\Claude\claude_desktop_config.json 에 추가합니다:

{
"mcpServers": {
"codetree": {
...

Claude Desktop 은 ${workspaceFolder} 을 지원하지 않으므로, 여기서는 전체 경로를 사용하세요.

| 대안 | 한계 | codetree |
|---|---|
| 파일 직접 읽기 | 토큰 소모가 많고 구조나 관계가 없음 | 25 배 토큰 감소, 구조화된 출력 제공 |
| grep / ripgrep | 텍스트만 처리, AST 인식 없음, 호출 그래프 없음 | 코드 구조 이해, 텍스트 이상 |
| LSP 서버 | 무겁고 상태 유지, 언어별 설정 필요 | 한 명령어로 10 개 언어 지원, 상태 없는 MCP |
| SCIP / LSIF 인덱서 | 느린 빌드, 복잡한 설정, 거대한 인덱스 | ~1 초 시작 시간, JSON 캐시, 제로 설정 |
| AST 만 도구 | 원본 트리는 길고 에이전트에게 어려움 | 에이전트를 위한 사전 구조화된 출력 제공 |

Agent (Claude, Copilot, Cursor, etc.)
│ MCP (stdio)
▼
...

pip install tree-sitter-LANG

그리고 pyproject.toml 에 추가합니다:

• src/codetree/languages/_template.py 를 복사하여 languages/yourlang.py 로 생성하세요.
• 추상 방법을 구현하세요.
• registry.py 에서 확장자를 등록하세요.
• 테스트를 추가하세요.

git clone https://github.com/ThinkyMiner/codeTree.git
cd codeTree
python -m venv .venv
...

기여 환영합니다! 설정 지침과 가이드라인은 CONTRIBUTING.md 를 참조하세요.