AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Dev Tooling/
java-sdk
java-sdk logo

java-sdk

Active·★ 3.7k·MIT·Updated 2026-10-27
★ Essential

This is the official Java SDK for the Model Context Protocol, letting Java applications act as MCP clients or servers through a standard interface. It supports both synchronous and asynchronous styles and is published to Maven Central as `io.modelcontextprotocol.sdk:mcp`; the README badge points to JDK 17. The README links to documentation for features, architecture, dependencies and BOM, and separate client and server guides, and notes that Spring AI MCP extends the SDK with Spring Boot client and server starters.

Most of the README explains design decisions. JSON uses Jackson behind an SDK abstraction in `mcp-core`, so other libraries can be plugged in. The public programming model is Reactive Streams, implemented internally with Project Reactor, with a synchronous facade on top for simple blocking use. Logging uses SLF4J, with Reactor Context for observability propagation, and the SDK supports both client transports and server transports with authorization. The README also covers building from source, running unit and conformance tests, and lists future directions.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-25.

License
MIT
Latest release
v2.1.0 · 2026-10-16
Last commit
2026-10-23
Contributors
91
Forks
1,113
Open issues and PRs
287
First published
2025-01-20

Source: GitHub, npm and PyPI public APIs.

#Java SDK#AI Integration#API Wrapper#Asynchronous#Reactive Programming#Spring Boot#JSON Serialization
$ Install
$ ./mvnw clean install -DskipTests
↗ Visit site★ GitHub
01

Features

01Standardized AI model and tool interaction
02Support for synchronous and asynchronous communication
03Pluggable JSON serialization (Jackson by default)
04Reactive Streams programming model (Project Reactor) with synchronous facade
05Comprehensive Spring Boot integration via Spring AI MCP
02

Why choose it

+Official SDK from the MCP project, published on Maven Central
+Both synchronous and asynchronous APIs, so simple blocking use does not require learning Reactor
+Pluggable JSON layer instead of hard-wiring Jackson into the public API
+Works with Spring through the Spring AI MCP starters
03

Trade-offs

!Requires JDK 17 or newer
!The README is mostly design rationale and links; code samples live on the separate documentation site
!The async API is built on Reactor, which adds a learning curve; the README also says the public API is still being moved to plain Reactive Streams interfaces
!Spring Boot support is in the separate Spring AI project, not in this repository
04

Maintenance check

ActiveChecked: 2026-10-27
Last commit
2026-10-27
Commits, last 90 days
100+
Releases, last 90 days
7
Latest release
v2.2.0-M1 (2026-10-16)
Open issues
294
Recent issues with at least one comment
5/7
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 0, 6, 6, 7, 3, 13, 0, 1, 6, 20, 35, 2

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #578 Add Primitive repository APIs (`ResourceRepository`, `ToolsRepository`, ... )20 comments · 2025-09-26
  • #274 McpServerSession lifecycle doesn't support distributed services17 comments · 2025-05-28
  • #902 Stabilize flaky test: McpCompletionTests.testCompletionErrorOnMissingContext14 comments · 2026-04-04
  • #156 Optimization - avoid unnecessary payload copy when deserializing12 comments · 2025-04-14
  • #1011 SEP-2575: Make MCP Stateless11 comments · 2026-06-06

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Java
Runtime
Verified via docs
Spring AI
Integration
Verified via docs
Jakarta Servlet
Server Transport
Verified via docs
JDK HttpClient
Client Transport
Verified via docs
Jackson
JSON Serialization
Verified via docs
Project Reactor
Reactive Programming
Verified via docs
06

Quick start

1
$ ./mvnw clean install -DskipTests
07

Use cases

↳Developing Java applications that consume Model Context Protocol servers
↳Implementing and configuring custom Model Context Protocol servers in Java
↳Bootstrapping AI applications with integrated Model Context Protocol support
↳Building non-blocking, stream-processing AI applications
08

Alternatives

⚡Top VS:
VSrust-sdk★4.1k→VSgodot-ai★3.2k→VSruby-sdk★940→VSlaradashboard★419→
rust-sdk logo
rust-sdk★ 4.1k
The official Rust SDK for the Model Context Protocol
VSCompare→
godot-ai logo
godot-ai★ 3.2k
Production-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.
VSCompare→
ruby-sdk logo
ruby-sdk★ 940
The official Ruby SDK for the Model Context Protocol.
VSCompare→
laradashboard logo
laradashboard★ 419
⚡ Lara Dashboard - CMS by Laravel - All In One solution to start your Laravel Application from Basic to Enterprise. Manages Users, Roles, Permissions, Modules, Settings, Translations, Contents, Monitoring and every actions of your Laravel application. Complete solution for Laravel application with Tailwind, Livewire, Rest API, Unit-Tests and more.
VSCompare→
MARS logo
MARS★ 400
REST framework for Delphi: JAX-RS style resources and routes, servers and clients, JWT, OpenAPI 3, FireDAC and Devart UniDAC/MyDAC/IBDAC, SSE, MCP servers for AI agents. Windows, Linux, Docker.
VSCompare→
glade-mcp logo
glade-mcp★ 213
Connect any MCP-compatible AI client (Claude Code, Cursor, Windsurf) to Unity or Godot. 235+ granular tools, a Unity-aware system prompt, game design document project context, script semantic search, and skill calibration.
VSCompare→
dext logo
dext★ 329
Dext - Modern Full Stack Framework for Delphi
VSCompare→
universal-bluetooth-sdk logo
universal-bluetooth-sdk★ 36
Experimental Go Bluetooth daemon and CLI with Linux RFCOMM, MCP tools, and a hardware-free demo. Building toward nearby chat and optional local AI.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
modelcontextprotocol /
java-sdk
↗

Official Java SDK for the Model Context Protocol

3.7k1.1kMIT
Last commit1d ago
StatusActive
CategoryDev Tooling
Contributors91
Latest releasev2.1.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.