ariadne MCP server

ariadne MCP Server for Affected Test Selection

ariadne is an MCP (Model Context Protocol) server that provides AI agents with the ability to identify affected tests. Powered by sazanami, it analyzes code changes and returns only the tests that need to be run.

[!IMPORTANT]

## ⚠️ MUST READ: Speed over Completeness

ariadne is built for the agent inner loop — edit, verify, commit — where fast

feedback matters more than exhaustive selection. Static analysis cannot trace

every execution path: reflection, DI frameworks, and data-flow indirection

(e.g., Flux/MVI dispatch) can hide dependencies from any

affected-test-selection tool, not just ariadne.

Always keep a final line of defense in CI. Run the full test suite (or a

conservative selection) before merging. ariadne narrows what an agent runs

while iterating; it is not a replacement for CI.

When ariadne detects changes it cannot analyze (build scripts, resources,

unscanned source sets), it says so explicitly in the tool response instead of

silently reporting "no affected tests".

Features

• MCP Integration — Works with Claude Code, Claude Desktop, and other MCP-compatible clients
• Automatic Git Diff — No need to pass diff manually; ariadne runs git diff internally
• Powered by sazanami — Uses Kotlin Analysis API for accurate static analysis

Installation

Homebrew (recommended)

brew install mikhailhal/tap/ariadne

Then register it with your MCP client — for Claude Code:

claude mcp add ariadne -- ariadne

Or add to your MCP client configuration manually (e.g., Claude Desktop):

{
  "mcpServers": {
    "ariadne": {
      "command": "ariadne"
    }
  }
}

Docker

docker run -i --rm -v /path/to/project:/workspace ghcr.io/mikhailhal/ariadne

Mount the project you want analyzed and pass /workspace as project_path. The image is also listed in the official MCP Registry as io.github.MikhailHal/ariadne.

Manual (release JAR)

Download ariadne--all.jar from Releases (requires JDK 21+) and configure your client with "command": "java", "args": ["-jar", "/path/to/ariadne--all.jar"].

Build from Source

Shortened. The full README is on GitHub.