Ariadne

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

El hilo de Ariadna: una salida al laberinto de los microservicios.

Grafo de dependencias de API entre servicios para pilas de microservicios Spring Boot + TypeScript. Servidor MCP stdio para asistentes de programación con IA (Claude Code, Cursor, Windsurf), con un gemelo CLI. SQLite local + TF-IDF. Cero dependencias de ML.

👁 Demostración de Ariadne: escanea los microservicios de Spring PetClinic y pregunta por "owner"

Qué hace

Indexa la capa de contrato: mutaciones GraphQL, endpoints REST, temas Kafka, consultas de frontend. Nada más. Por eso los resultados caben en una ventana de contexto de IA.

Pregúntale a Claude "¿dónde vive createOrder en toda la pila?" y query_chains devuelve:

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 de ida y vuelta. El equivalente a grep -r createOrder en cuatro repositorios devuelve más de 40 coincidencias en DTOs, pruebas y configuraciones con ~2000 tokens, con la capa de contrato enterrada.

Compatible con: GraphQL · Spring HTTP/Kafka/RestClient · TypeScript Apollo/fetch/axios · Cube.js.

Related MCP server: depwire

Pruébalo en 30 segundos (sin configuración)

pip install ariadne-mcp
ariadne-mcp demo

Clona spring-petclinic-microservices en ~/.cache/ariadne-mcp/demo, lo escanea e imprime el clúster principal para owner: una cadena de llamadas real entre servicios. Sin archivo de configuración, sin configuración de espacio de trabajo.

Instálalo en tu propio espacio de trabajo

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

Reinicia Claude Code. install es idempotente: vuelve a ejecutarlo después de descargar código nuevo, o deja que el asistente llame a rescan ante una stale_warning.

Configuración

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

Los escáneres se infieren a partir de los archivos de nivel superior de cada repositorio (pom.xml / build.gradle / package.json / SDL). Consulta docs/CONFIG.md para ver la tabla de detección y la sintaxis de anulación.

Pruébalo con un ejemplo público

examples/spring-petclinic/: clona el ejemplo público spring-petclinic-microservices, añade la configuración, escanea y consulta. Reproducible de principio a fin en menos de un minuto.

Arquitectura, herramientas MCP, matemáticas de puntuación, mejora de feedback → docs/ARCHITECTURE.md. Escáneres personalizados (Go, Rust, cualquier cosa) → docs/CUSTOM_SCANNERS.md.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• expand_nodeA
• query_chainsA
• rate_resultA
• rescanA
• show_helpA