convez.ai
PluginIntegração & APIsIntermediário
whyy9527

Ariadne — Grafo de Dependências entre Microserviços

whyy9527/ariadne

Mapeia fluxos de dados entre microserviços para Claude, Cursor e Windsurf

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta 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/ariadne

1 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

Estrelas
4
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
v0.2.2
Issues abertas
0
Contribuidores
2

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

License: MIT MCP ariadne MCP server Awesome MCP Servers

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.

Ariadne demo — scan Spring PetClinic microservices and ask "owner"


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.

Ver o original no GitHub

Bom para

Relacionados