tentra-mcp

npm version npm downloads License: MIT

Память для ИИ-агентов по написанию кода. Постоянный граф кода + архитектурные диаграммы, созданные ИИ — на базе MCP. Работает в Cursor, Claude Code, Codex и Windsurf.

Бенчмарк на нашем собственном монорепозитории: сокращение токенов на 99,4% (коэффициент 156,8×) для 8 запросов типа «где реализовано X?» — 114 644 токена при повторном чтении файлов против 731 токена через query_symbols. Полный отчет →

Быстрый старт

npx tentra-mcp

При первом использовании откроется браузер для входа через GitHub в один клик. Это всё — API-ключ не требуется.

Дополнительно: Если вы предпочитаете использовать API-ключ напрямую, выполните npx tentra-mcp --key YOUR_API_KEY. Получите свой ключ на trytentra.com/settings.

Что такое Tentra?

Tentra — это уровень постоянной памяти для ИИ-агентов по написанию кода. Опишите систему — получите диаграмму и экспорт кода для 14 фреймворков. Индексируйте свой репозиторий — агенты будут запрашивать структурированный граф файлов, символов, импортов и вызовов вместо повторного поиска по исходному коду в каждой сессии.

Этот MCP-сервер предоставляет вашему ИИ-ассистенту 32 инструмента:

Архитектура (9 инструментов)

Инструмент	Описание
`create_architecture`	Проектирование новой системы на основе описания
`update_architecture`	Изменение существующей архитектуры
`get_architecture`	Чтение деталей архитектуры
`list_architectures`	Просмотр всех сохраненных проектов
`analyze_codebase`	Сканирование локального кода и создание диаграммы
`lint_architecture`	Проверки качества (9 правил: «сироты», единые точки отказа, «божественные» сервисы)
`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`	Косинусное ANN-расстояние pgvector по эмбеддингам, созданным агентом
`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 (без установки)

Добавьте в конфигурацию MCP вашей IDE — локальная установка не требуется:

Cursor (Settings > Features > MCP > Add Server):

{
  "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

tentra