Ariadne

👁 License: MIT
👁 MCP
👁 ariadne MCP server
👁 Awesome MCP Servers

Нить Ариадны — выход из лабиринта микросервисов.

Граф зависимостей API между сервисами для стеков Spring Boot + TypeScript. MCP stdio-сервер для ИИ-ассистентов (Claude Code, Cursor, Windsurf) с CLI-аналогом. Локальная база SQLite + TF-IDF. Никаких ML-зависимостей.

👁 Демонстрация Ariadne — сканирование микросервисов Spring PetClinic и запрос "owner"

Что это делает

Индексирует уровень контрактов — GraphQL-мутации, REST-эндпоинты, Kafka-топики, фронтенд-запросы. Больше ничего. Именно поэтому результаты помещаются в контекстное окно ИИ.

Спросите Claude: "где в стеке используется createOrder?", и query_chains вернет:

Top Cluster #1 [confidence: 0.91]
 Services: gateway, orders-svc, billing-svc, web
 - [web] Frontend Mutation: createOrder
 - [gateway] GraphQL Mutation: createOrder
 - [orders-svc] HTTP POST /orders: createOrder
 - [orders-svc] Kafka Topic: order-created
 - [billing-svc] Kafka Listener: order-created → chargeCustomer

Около 500 токенов за запрос. Эквивалентный grep -r createOrder по четырем репозиториям вернет 40+ совпадений в DTO, тестах и конфигах объемом около 2000 токенов, где уровень контрактов будет скрыт.

Поддерживает: GraphQL · Spring HTTP/Kafka/RestClient · TypeScript Apollo/fetch/axios · Cube.js.

Related MCP server: depwire

Попробуйте за 30 секунд (без настройки)

pip install ariadne-mcp
ariadne-mcp demo

Клонирует spring-petclinic-microservices в ~/.cache/ariadne-mcp/demo, сканирует его и выводит основной кластер для owner — реальную цепочку вызовов между сервисами. Никаких файлов конфигурации, никакой настройки рабочего пространства.

Установка в вашем рабочем пространстве

pip install ariadne-mcp
cp "$(python -c 'import ariadne_mcp, os; print(os.path.join(os.path.dirname(ariadne_mcp.__file__), "ariadne.config.example.json"))')" ariadne.config.json
# edit ariadne.config.json (list the repos you want indexed)
ariadne-mcp install ariadne.config.json ~/your-workspace

Перезапустите Claude Code. Команда install идемпотентна — запускайте её повторно после получения нового кода или позвольте ассистенту вызвать rescan при появлении stale_warning.

Конфигурация

{ "repos": [
 { "path": "../gateway" },
 { "path": "../orders-svc" },
 { "path": "../web" }
]}

Сканеры определяются автоматически на основе файлов верхнего уровня в каждом репозитории (pom.xml / build.gradle / package.json / SDL). См. docs/CONFIG.md для таблицы обнаружения и синтаксиса переопределения.

Попробуйте на публичном примере

examples/spring-petclinic/ — клонируйте публичный пример spring-petclinic-microservices, добавьте конфиг, просканируйте и выполните запрос. Воспроизводимый полный цикл менее чем за минуту.

Архитектура, инструменты MCP, математика оценки, обратная связь → docs/ARCHITECTURE.md. Пользовательские сканеры (Go, Rust и любые другие) → docs/CUSTOM_SCANNERS.md.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• expand_nodeA
• query_chainsA
• rate_resultA
• rescanA
• show_helpA