Ariadne — Grafo de Dependências entre Microserviços
whyy9527/ariadne
Mapeia fluxos de dados entre microserviços para Claude, Cursor e Windsurf
Ver no GitHubFerramenta que mapeia cadeias de chamadas entre serviços em arquiteturas Spring Boot + TypeScript (GraphQL, REST, Kafka, frontend). Funciona como MCP server e CLI, indexando a camada de contrato (mutations, endpoints, topics) com análise estática offline e TF-IDF, mantendo resultados compactos para contexto de IA.
Instalação
npx convez-ai whyy9527/ariadne1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Descobrir onde uma mutação/endpoint específica é implementada em stack de múltiplos serviços
- Rastrear cadeias de chamadas REST + Kafka entre Spring Boot e frontends TypeScript
- Análise de impacto ao modificar contrato de API em microserviços
Veredito

Solução bem focada para equipes com stacks Spring + TypeScript fragmentados. O indexing offline e limitação ao contrato (sem ruído de DTOs/testes) é decisão arquitetural sólida para manter tokens baixos. Funciona — teste em 30s com o demo.
README
A tradução para o português deste README ainda está na fila.
Ariadne
Ariadne's thread — a way out of the microservice maze.
Cross-service API dependency graph for Spring Boot + TypeScript microservice stacks. MCP stdio server for AI coding assistants (Claude Code, Cursor, Windsurf), with a CLI twin. Local SQLite + TF-IDF. Zero ML dependencies.

What it does
Indexes the contract layer — GraphQL mutations, REST endpoints, Kafka topics, frontend queries. Nothing else. That's why results fit an AI context window.
Ask Claude "where does createOrder live across the stack?" and
query_chains returns:
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 tokens round-trip. The equivalent grep -r createOrder across
four repos returns 40+ matches across DTOs, tests, and configs at
~2000 tokens, with the contract layer buried.
Supports: GraphQL · Spring HTTP/Kafka/RestClient · TypeScript Apollo/fetch/axios · Cube.js.
Try it in 30 seconds (zero config)
pip install ariadne-mcp
ariadne-mcp demo
Clones spring-petclinic-microservices into
~/.cache/ariadne-mcp/demo, scans it, and prints the top cluster for
owner — a real cross-service call chain. No config file, no workspace
setup.
Install on your own workspace
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
Restart Claude Code. install is idempotent — re-run after pulling new
code, or let the assistant call rescan on a stale_warning.
Config
{ "repos": [
{ "path": "../gateway" },
{ "path": "../orders-svc" },
{ "path": "../web" }
]}
Scanners are inferred from each repo's top-level files
(pom.xml / build.gradle / package.json / SDL). See
docs/CONFIG.md for the detection table and override
syntax.
Try it on a public sample
examples/spring-petclinic/ — clone the
public spring-petclinic-microservices sample, drop in the config,
scan, query. Reproducible end-to-end in under a minute.
Architecture, MCP tools, scoring math, feedback boost →
docs/ARCHITECTURE.md. Custom scanners (Go,
Rust, anything) → docs/CUSTOM_SCANNERS.md.