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"를 검색

기능

계약 계층(contract layer) — 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