Ariadne

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

阿里阿德涅之线（Ariadne's thread）——走出微服务迷宫的指引。

专为 Spring Boot + TypeScript 微服务技术栈设计的跨服务 API 依赖关系图。它是面向 AI 编程助手（Claude Code、Cursor、Windsurf）的 MCP stdio 服务器，并配有 CLI 工具。基于本地 SQLite + TF-IDF 实现，无任何机器学习依赖。

👁 Ariadne 演示 — 扫描 Spring PetClinic 微服务并询问 "owner"

功能概述

索引契约层——包括 GraphQL Mutation、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 个 token。而在四个代码库中执行等效的 grep -r createOrder 会返回 40 多个匹配项（包含 DTO、测试和配置），占用约 2000 个 token，且契约层被淹没其中。

支持：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 示例，放入配置，扫描，查询。在一分钟内即可完成端到端的复现。

架构、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