whyy9527

Ariadne — Development skill for Claude Code

Development community

Fast local MCP server for deterministic cross-service API-chain discovery across REST, GraphQL, Kafka, TypeScript, and FastAPI.

How to install Ariadne

This entry records only its repository, not the path inside it, so there is no exact command to give. Open whyy9527/ariadne and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ariadne does

Fast local MCP server for deterministic cross-service API-chain discovery across REST, GraphQL, Kafka, TypeScript, and FastAPI.

Alternatives in Development

Storybloq — Cross-session context for Claude Code 696 ★
Claw Code Agent — Claw Code No Rust No TypeScript Only Python 543 ★
Claude Code TypeScript Hooks — Fast, intelligent quality checks for different project types 172 ★

README

Ariadne

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-stdio-8A2BE2)](https://modelcontextprotocol.io) [![ariadne MCP server](https://glama.ai/mcp/servers/whyy9527/ariadne/badges/score.svg)](https://glama.ai/mcp/servers/whyy9527/ariadne) [![Awesome MCP Servers](https://img.shields.io/badge/Awesome-MCP%20Servers-FC60A8?logo=awesomelists)](https://github.com/punkpeye/awesome-mcp-servers#-developer-tools)

Ariadne's thread — a way out of the microservice maze.

Cross-service API dependency graph for Spring Boot + TypeScript microservice stacks. MCP stdio server for AI coding assistants (Claude Code, Cursor, Windsurf), with a CLI twin. Local SQLite + TF-IDF. Zero ML dependencies.

![Ariadne demo — scan Spring PetClinic microservices and ask "owner"](docs/demo.gif)

70-second deterministic terminal walkthrough. Reproduce it from [`docs/demo.tape`](docs/demo.tape).

What it does

Indexes the *contract layer* — GraphQL mutations, REST endpoints, Kafka topics, frontend queries. Nothing else. That's why results fit an AI context window.

Ask Claude *"where does createOrder live across the stack?"* and `query_chains` returns:

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

The response is intentionally bounded for an AI context window. See the [reproducible public-stack benchmark](BENCHMARKS.md) for measured retrieval, serialized token, and timing results against `rg` and `grep`.

Current public-stack benchmark (48 reviewed queries across Spring REST, GraphQL/TypeScript, Kafka, and FastAPI):

| Backend | Top-1 | Top-3 | M