tentra-mcp

👁 npm version
👁 npm downloads
👁 CI
👁 License: MIT

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

자체 모노레포에서 수행한 벤치마크 결과: 8개의 "X가 어디에 구현되어 있나요?" 쿼리에서 토큰 99.4% 절감 (156.8배 비율) — 파일 재읽기를 통한 114,644 토큰 대비 query_symbols를 통한 731 토큰. 전체 글 보기 →

빠른 시작 (60초)

cd your-repo
npx tentra-mcp init --hook

한 번의 명령어로:

1. Cursor / Claude Code / Codex / Windsurf (설치된 항목)를 위한 MCP 설정을 작성합니다.

2. git post-commit 훅을 설치하여 커밋할 때마다 코드 그래프가 자동으로 새로 고침되도록 합니다 (수동 인덱싱 불필요).

3. git 원격 저장소에서 repo_id를 자동으로 추출하여 .tentra/metadata.json에 저장합니다.

그런 다음 trytentra.com/settings에서 API 키를 가져와 생성된 설정 파일의 YOUR_TENTRA_API_KEY를 교체하고, IDE를 다시 로드한 뒤 에이전트에게 다음과 같이 물어보세요:

Index this codebase with Tentra and list the god-nodes

이제부터 모든 git commit 시 백그라운드에서 재인덱싱이 실행됩니다. 에이전트는 자동으로 최신 상태를 유지합니다.

훅 건너뛰기: --hook을 제외하면 IDE 설정만 작성됩니다. 수동 stdio 설치: npx tentra-mcp (첫 도구 호출 시 GitHub 장치 흐름 인증을 위해 브라우저가 열립니다). API 키 사용: npx tentra-mcp --key YOUR_API_KEY.

Related MCP server: codecortex

Tentra란 무엇인가요?

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

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

아키텍처 (9개 도구)

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

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

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

설정

옵션 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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• analyze_codebaseA
• bind_contractA
• create_architectureA
• create_flowA
• diff_snapshotsA
• explain_code_pathA
• export_architectureB
• find_similar_codeC