tentra-mcp

npm version npm downloads License: MIT

AI 코딩 에이전트를 위한 메모리입니다. 영구 코드 그래프와 AI가 생성한 아키텍처 다이어그램을 제공하며, MCP를 기본 지원합니다. Cursor, Claude Code, Codex 및 Windsurf에서 작동합니다.

자체 모노레포에서 수행한 벤치마크 결과: 8개의 "X가 어디에 구현되어 있는가?" 쿼리에서 99.4%의 토큰 절감(156.8배 비율)을 달성했습니다. 파일 재읽기를 통한 114,644 토큰 대비 query_symbols를 사용하여 731 토큰을 기록했습니다. 전체 내용 보기 →

빠른 시작

npx tentra-mcp

처음 사용할 때 브라우저가 열리며 원클릭 GitHub 로그인이 진행됩니다. 별도의 API 키는 필요하지 않습니다.

고급: API 키를 직접 사용하려면 npx tentra-mcp --key YOUR_API_KEY를 실행하세요. 키는 trytentra.com/settings에서 발급받을 수 있습니다.

Tentra란 무엇인가요?

Tentra는 AI 코딩 에이전트를 위한 영구 메모리 계층입니다. 시스템을 설명하면 다이어그램과 14개 프레임워크의 코드 내보내기를 제공합니다. 저장소를 인덱싱하면 에이전트가 매 세션마다 소스 코드를 다시 검색(grep)하는 대신 파일, 심볼, 임포트 및 호출 에지로 구성된 구조화된 그래프를 쿼리합니다.

이 MCP 서버는 AI 어시스턴트에게 32개의 도구를 제공합니다:

아키텍처 (9개 도구)

도구	설명
`create_architecture`	설명으로부터 새로운 시스템 설계
`update_architecture`	기존 아키텍처 수정
`get_architecture`	아키텍처 세부 정보 읽기
`list_architectures`	저장된 모든 설계 탐색
`analyze_codebase`	로컬 코드 스캔 및 다이어그램 생성
`lint_architecture`	품질 검사 (9가지 규칙: 고아, SPOF, 갓 서비스 등)
`sync_architecture`	다이어그램과 코드 간의 드리프트 감지
`export_architecture`	14개 프레임워크로 내보내기 (Java, Python, Go, Rust 등)
`create_flow`	단계별 흐름 시각화 생성

코드 그래프 — 쓰기 (4개 도구)

도구	설명
`index_code`	저장소를 탐색하고 로컬에서 Tree-sitter를 실행하여 의미론적 인덱싱 작업 시작
`index_code_continue`	진행 중인 인덱싱 작업 재개
`record_semantic_node`	에이전트가 추출한 의미론적 주석 영구 저장
`get_index_job`	인덱싱 작업 상태 확인

코드 그래프 — 읽기 (10개 도구)

도구	설명
`query_symbols`	인덱싱된 심볼에 대한 퍼지 트라이그램 검색
`get_symbol_neighbors`	호출/임포트 그래프에서 BFS 탐색
`get_service_code_graph`	캔버스 서비스를 위한 서브그래프
`explain_code_path`	의미론적 맥락을 포함한 두 심볼 간의 최단 경로
`find_similar_code`	에이전트가 생성한 임베딩에 대한 pgvector 코사인 ANN
`record_embedding`	에이전트가 생성한 임베딩 벡터 영구 저장
`list_god_nodes`	가장 높은 팬인/팬아웃 심볼 (아키텍처 스멜)
`get_quality_hotspots`	변경 빈도 × 복잡도 순위
`list_snapshots`	인덱싱된 스냅샷의 시간순 목록
`diff_snapshots`	스냅샷 간 추가/삭제된 파일 / 심볼 / 갓 노드 비교

강화 — 계약, 결정, 소유권, 도메인 (9개 도구)

도구	설명
`set_service_mapping`	인덱싱된 파일이나 심볼을 캔버스 서비스에 연결
`set_domain_membership`	서비스나 파일을 도메인(경계 컨텍스트)에 할당
`record_contract`	파싱된 API 계약 페이로드 저장 (OpenAPI, GraphQL, Protobuf)
`bind_contract`	계약을 구현하는 심볼에 연결
`record_decision`	아키텍처 결정 기록(ADR) 생성 (코드 연결 가능)
`link_decision`	ADR에서 다른 심볼, 파일 또는 서비스로 링크 추가
`get_ownership`	파일이나 서비스의 소유자(팀 또는 개인) 확인
`get_decisions_for`	특정 엔티티에 연결된 ADR 목록
`get_contracts`	종류나 서비스별로 필터링 가능한 계약 목록

설정

옵션 1: SSE (설치 불필요)

IDE의 MCP 설정에 추가하세요. 로컬 설치가 필요 없습니다:

Cursor (설정 > 기능 > MCP > 서버 추가):

{
  "tentra": {
    "type": "sse",
    "url": "https://trytentra.com/api/mcp?key=YOUR_API_KEY"
  }
}

Claude Code (프로젝트 루트의 .mcp.json):

{
  "mcpServers": {
    "tentra": {
      "type": "sse",
      "url": "https://trytentra.com/api/mcp?key=YOUR_API_KEY"
    }
  }
}

옵션 2: 로컬 설치 (코드베이스 스캔 시 필요)

npx tentra-mcp

처음 사용할 때 GitHub를 통해 자동으로 인증됩니다. 자격 증명은 ~/.tentra/credentials에 저장됩니다.

Cursor 로컬 서버 설정:

{
  "tentra": {
    "command": "npx",
    "args": ["tentra-mcp"]
  }
}

Claude Code (.mcp.json):

{
  "mcpServers": {
    "tentra": {
      "command": "npx",
      "args": ["tentra-mcp"]
    }
  }
}

사용 예시

연결 후 AI에게 다음과 같이 요청하세요:

"Design a payment system with Stripe, Kafka, and PostgreSQL"
→ AI calls create_architecture → diagram at trytentra.com/arch/xxx

"Scan this codebase and generate the architecture"
→ AI calls analyze_codebase → detects services, DBs, queues

"Export this architecture to Java Spring Boot"
→ AI calls export_architecture → downloads zip with project scaffold

"What changed since last time? Is my diagram outdated?"
→ AI calls sync_architecture → drift report with accuracy score

내보내기 형식

Java (Spring Boot), Node.js (Fastify), Python (FastAPI), Go (chi), Rust (Axum), .NET (ASP.NET), Kotlin (Ktor), PHP (Laravel), Ruby (Rails), Elixir (Phoenix), Docker Compose, Mermaid, ADR, Terraform

링크

웹사이트: trytentra.com
문서: trytentra.com/docs
설정 가이드: trytentra.com/docs/setup
갤러리: trytentra.com/gallery

개발

이 저장소에는 오픈 소스 MCP 서버가 포함되어 있습니다. Tentra API와 웹 앱은 trytentra.com에서 별도로 호스팅되는 서비스입니다.

npm install --legacy-peer-deps
npm run build      # tsc --noEmit + esbuild bundle → dist/index.js
npm start          # run the bundled server
npm test           # vitest

배포된 npm 패키지(tentra-mcp)에는 번들된 dist/만 포함되어 있으며, 소스 코드는 감사 및 커뮤니티 기여를 위해 여기에 공개되어 있습니다.

라이선스

MIT

tentra