Ariadne

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

アリアドネの糸 — マイクロサービスの迷宮からの脱出。

Spring Boot + TypeScriptマイクロサービススタック向けのサービス間API依存関係グラフ。AIコーディングアシスタント（Claude Code、Cursor、Windsurf）用のMCP stdioサーバーであり、CLI版も提供。ローカルSQLite + TF-IDFを使用。ML依存関係はゼロ。

👁 Ariadneデモ — Spring PetClinicマイクロサービスをスキャンして「owner」を検索

機能

コントラクト層（GraphQLミューテーション、RESTエンドポイント、Kafkaトピック、フロントエンドクエリ）のみをインデックス化します。それ以外は対象外です。そのため、結果がAIのコンテキストウィンドウに収まります。

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トークン。4つのリポジトリに対してgrep -r createOrderを実行すると、DTO、テスト、設定ファイル全体で40件以上のマッチが返され、約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は冪等（べきとう）です。新しいコードをプルした後に再実行するか、stale_warningが表示された際にアシスタントにrescanを呼び出させてください。

設定

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

スキャナーは各リポジトリのトップレベルファイル（pom.xml / build.gradle / package.json / SDL）から推論されます。検出テーブルとオーバーライド構文についてはdocs/CONFIG.mdを参照してください。

公開サンプルで試す

examples/spring-petclinic/ — 公開されているspring-petclinic-microservicesサンプルをクローンし、設定ファイルを配置して、スキャンとクエリを実行してください。1分以内にエンドツーエンドで再現可能です。

アーキテクチャ、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