tentra-mcp
👁 npm version
👁 npm downloads
👁 CI
👁 License: MIT
Память для ИИ-агентов по написанию кода. Постоянный граф кода + архитектурные диаграммы, созданные ИИ — на базе MCP. Работает в Cursor, Claude Code, Codex и Windsurf.
Бенчмарк на нашем собственном монорепозитории: сокращение токенов на 99,4% (коэффициент 156,8×) для 8 запросов типа «где реализован X?» — 114 644 токена при повторном чтении файлов против 731 токена через query_symbols. Полный отчет →
Быстрый старт (60 секунд)
cd your-repo
npx tentra-mcp init --hookОдна команда:
Записывает конфигурацию MCP для Cursor / Claude Code / Codex / Windsurf (в зависимости от того, что установлено)
Устанавливает git-хук
post-commit, чтобы граф кода автоматически обновлялся после каждого коммита — никакой ручной индексацииАвтоматически определяет ваш
repo_idиз удаленного git-репозитория и сохраняет его в.tentra/metadata.json
Затем получите свой API-ключ на trytentra.com/settings, замените YOUR_TENTRA_API_KEY в сгенерированной конфигурации, перезагрузите IDE и спросите своего агента:
Index this codebase with Tentra and list the god-nodesС этого момента каждый git commit запускает фоновую переиндексацию. Ваши агенты автоматически остаются в курсе изменений.
Пропустить хук: используйте
--hook— будут записаны только конфигурации IDE. Ручная установка stdio:npx tentra-mcp(открывает браузер для авторизации через GitHub device-flow при первом вызове инструмента). Использование API-ключа:npx tentra-mcp --key YOUR_API_KEY.
Related MCP server: codecortex
Что такое Tentra?
Tentra — это уровень постоянной памяти для ИИ-агентов по написанию кода. Опишите систему — получите диаграмму и экспорт кода для 14 фреймворков. Индексируйте свой репозиторий — агенты будут запрашивать структурированный граф файлов, символов, импортов и связей вызовов вместо того, чтобы каждый раз заново искать по исходному коду.
Этот MCP-сервер предоставляет вашему ИИ-ассистенту 32 инструмента:
Архитектура (9 инструментов)
Инструмент | Описание |
| Проектирование новой системы на основе описания |
| Изменение существующей архитектуры |
| Чтение деталей архитектуры |
| Просмотр всех сохраненных проектов |
| Сканирование локального кода и создание диаграммы |
| Проверки качества (9 правил: «сиротские» узлы, единые точки отказа, «божественные» сервисы) |
| Обнаружение расхождений между диаграммой и кодом |
| Экспорт в 14 фреймворков (Java, Python, Go, Rust и др.) |
| Создание пошаговой визуализации потока |
Граф кода — Запись (4 инструмента)
Инструмент | Описание |
| Обход репозитория, локальный Tree-sitter, запуск задачи семантической индексации |
| Возобновление задачи индексации |
| Сохранение семантической аннотации, извлеченной агентом |
| Проверка статуса задачи индексации |
Граф кода — Чтение (10 инструментов)
Инструмент | Описание |
| Нечеткий триграммный поиск по индексированным символам |
| Обход в ширину (BFS) в графе вызовов/импортов |
| Подграф для сервиса на холсте |
| Кратчайший путь между двумя символами с семантическим контекстом |
| Косинусное ANN-сравнение через pgvector по эмбеддингам, созданным агентом |
| Сохранение вектора эмбеддинга, созданного агентом |
| Символы с наибольшим входящим/исходящим потоком (архитектурные «запахи») |
| Рейтинг по частоте изменений × сложности |
| Список индексированных снимков с возможностью перемещения во времени |
| Файлы / символы / «божественные» узлы, добавленные/удаленные между снимками |
Обогащение — Контракты, Решения, Владение, Домены (9 инструментов)
Инструмент | Описание |
| Привязка индексированного файла или символа к сервису на холсте |
| Назначение сервиса или файла домену (ограниченному контексту) |
| Сохранение распарсенного контракта API (OpenAPI, GraphQL, Protobuf) |
| Привязка контракта к символу, который его реализует |
| Создание записи об архитектурном решении (ADR), с опциональной привязкой к коду |
| Добавление ссылки из ADR на другой символ, файл или сервис |
| Определение владельца (команды или человека) для файла или сервиса |
| Список ADR, связанных с указанной сущностью |
| Список контрактов, с опциональной фильтрацией по типу или сервису |
Настройка
Вариант 1: SSE (без установки)
Добавьте в конфигурацию MCP вашей IDE — локальная установка не требуется:
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"]
}
}
}Примеры использования
После подключения просто общайтесь со своим ИИ:
"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-сервер с открытым исходным кодом. API Tentra и веб-приложение являются отдельным хостинг-сервисом на 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
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rdanieli/tentra-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
