Tachyon

Tachyon MCP is a Java 21+ server runtime for the Model Context Protocol. It implements MCP 2025-11-25 and 2026-07-28 over Streamable HTTP and passes the official conformance suites for both versions.

Build servers with synchronous Java handlers or a coroutine-first Kotlin DSL. Tachyon runs blocking handlers on virtual threads, keeps them off the Netty event loop, and requires no application framework.

Why Tachyon?

• Simple handlers -- write blocking Java code or suspending Kotlin code without reactive pipelines or manual thread pools.
• Stable application API -- protocol-version mappers isolate handlers from wire-format changes.
• Java annotations support -- adapt existing mcp-java, LangChain4j, or Spring AI annotated services into Tachyon MCP servers.
• Stateless by default -- opt into sessions only when you need resumable SSE, event replay, and TTL cleanup.
• Production transport -- Netty backpressure, graceful shutdown, DNS-rebinding protection, CORS, and native transport auto-detection (io_uring → epoll → kqueue → NIO).

Quickstart

Add the core dependency:

<dependency>
    <groupId>dev.tachyonmcp</groupId>
    <artifactId>tachyon-core</artifactId>
    <version>${tachyon.version}</version>
</dependency>

Create and start a server:

import dev.tachyonmcp.api.server.features.tools.ToolResult;
import dev.tachyonmcp.core.server.TachyonServer;

public class WeatherMcpServer {
    public static void main(String... args) {
        var server = TachyonServer.builder()
            .name("weather-mcp")
            .withTools(tools -> tools.register(
                tool -> tool.name("get_forecast")
                    .description("Get weather forecast")
                    .inputSchema("""
                        {"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}
                        """),
                (context, request) -> ToolResult.text("☀️ 22°C")))
            .port(8080)
            .build();
        server.start();
    }
}

See the quickstart for Java and Kotlin examples plus a curl test.

Implemented features

... View full README on GitHub