内容
阿里阿登
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/whyy9527/ariadne)
[](https://github.com/punkpeye/awesome-mcp-servers#-developer-tools)
> 阿里阿登的线索 — 走出微服务迷宫的路径。
适用于 Spring Boot + TypeScript 微服务堆栈的跨服务 API 依赖关系图。适用于 AI 编程助手（Claude Code、Cursor、Windsurf）的 MCP stdio 服务器，带有命令行界面。本地 SQLite + TF-IDF。零机器![阿里阿登演示 Spring PetClinic 微服务 "owner"](docs/demo.gif## 它能做什么
索引*契* — GraphQL REST 端点、Kafka 主前端查询。除此之外什么。这就是为什么结果适合 AI文窗口。
询问 Claude *" 在整个堆栈中位于哪里？query_chains`
```
Top Cluster #1置信度: 0 服务: gateway,vc, billing-svc, - [web] 前端 Mutation: createOrder
-] GraphQL Mutation:
- [orders] HTTP POST /ordersOrder
- [orders Kafka 主题:-created
- [billing-svc Kafka 监听器:-created → chargeCustomer
500 个令牌往返效的 `grep -r createOrder` 跨四个存储库40+ 个匹配项，跨 DTO、测试和配置，约 2000 个令牌，而契约埋葬。
支持：Graph Spring HTTP/Kafka/RestScript Apollo/fetch/axios.js。
---
## 30（零配置）
```bash
pip install ariadne-mcp
ariadne-mcp demo
```
克隆 [`spring-petclinic-microservices`][petclinic] 到 `~/.cache/ariadne-mcp/demo`，扫描它，并为 `owner` 打印顶部集群 — 一个真正的跨服务调用链。无需配置文件，无需工作区设置。
[petclinic]: https://github.com/spring-petclinic/spring-petclinic-microservices
---
## 在您自己的工作区安装
```bash
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
# 编辑 ariadne.config.json（列出您要索引的存储库）
ariadne-mcp install ariadne.config.json ~/your-workspace
```
重启 Claude Code。`install` 是幂等的 — 在拉取新代码后重新运行，或让助手在 `stale_warning` 上调用 `rescan`。
---
## 配置
```json
{ "repos": [
{ "path": "../gateway" },
{ "path": "../orders-svc" },
{ "path": "../web" }
]}
```
扫描器从每个存储库的顶级文件推断（`pom.xml` / `build.gradle` / `package.json` / SDL）。参见 [`docs/CONFIG.md`](docs/CONFIG.md) 获取检测表和覆盖语法。
---
## 在公共示例上试用
[`examples/spring-petclinic/`](examples/spring-petclinic/) — 克隆公共的 `spring-petclinic-microservices` 示例，放入配置文件，扫描，查询。在一分钟内可复制端到端。
---
<sub>架构，MCP 工具，评分数学，反馈增强 → [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)。自定义扫描器（Go，Rust，任何语言）→ [`docs/CUSTOM_SCANNERS.md`](docs/CUSTOM_SCANNERS.md).</sub>
