Ariadne

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

Ariadnes Faden — ein Ausweg aus dem Microservice-Labyrinth.

Übergreifender API-Abhängigkeitsgraph für Spring Boot + TypeScript Microservice-Stacks. MCP-stdio-Server für KI-Coding-Assistenten (Claude Code, Cursor, Windsurf), mit einem CLI-Zwilling. Lokales SQLite + TF-IDF. Keine ML-Abhängigkeiten.

👁 Ariadne Demo — scanne Spring PetClinic Microservices und frage nach "owner"

Was es tut

Indiziert die Vertragsebene — GraphQL-Mutationen, REST-Endpunkte, Kafka- Topics, Frontend-Abfragen. Nichts weiter. Deshalb passen die Ergebnisse in ein KI-Kontextfenster.

Frage Claude "wo lebt createOrder im gesamten Stack?" und query_chains gibt zurück:

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. Das äquivalente grep -r createOrder über vier Repos hinweg liefert 40+ Treffer in DTOs, Tests und Konfigurationen bei ~2000 Tokens, wobei die Vertragsebene verborgen bleibt.

Unterstützt: GraphQL · Spring HTTP/Kafka/RestClient · TypeScript Apollo/fetch/axios · Cube.js.

Related MCP server: depwire

In 30 Sekunden ausprobieren (ohne Konfiguration)

pip install ariadne-mcp
ariadne-mcp demo

Klont spring-petclinic-microservices nach ~/.cache/ariadne-mcp/demo, scannt es und gibt den Top-Cluster für owner aus — eine echte übergreifende Service-Aufrufkette. Keine Konfigurationsdatei, kein Workspace-Setup erforderlich.

Auf dem eigenen Workspace installieren

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

Starte Claude Code neu. install ist idempotent — führe es nach dem Abrufen von neuem Code erneut aus oder lass den Assistenten rescan bei einer stale_warning aufrufen.

Konfiguration

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

Scanner werden aus den Dateien auf oberster Ebene jedes Repos abgeleitet (pom.xml / build.gradle / package.json / SDL). Siehe docs/CONFIG.md für die Erkennungstabelle und die Override-Syntax.

An einem öffentlichen Beispiel ausprobieren

examples/spring-petclinic/ — klone das öffentliche spring-petclinic-microservices-Beispiel, füge die Konfiguration hinzu, scanne und frage ab. Reproduzierbar von Anfang bis Ende in unter einer Minute.

Architektur, MCP-Tools, Scoring-Mathematik, Feedback-Boost → docs/ARCHITECTURE.md. Eigene Scanner (Go, Rust, alles Mögliche) → docs/CUSTOM_SCANNERS.md.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• expand_nodeA
• query_chainsA
• rate_resultA
• rescanA
• show_helpA