LibreAI / Dev Tools / java-sdk
// devtools · modelcontextprotocol/java-sdk

java-sdk

The official Java SDK for building Model Context Protocol servers and clients.

★ 3.7k stars⑂ 1.2k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

java-sdk is an open-source dev tools project by modelcontextprotocol (modelcontextprotocol/java-sdk on GitHub). It has 3,723 GitHub stars and 1,155 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
3,723
Forks
1,155
License
MIT
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Official MCP implementation

Servers and clients implementing the Model Context Protocol specification for the JVM.

Transport-agnostic design

JDK HttpClient client transport and Jakarta Servlet server transport in core; Spring transports available through Spring AI.

Reactive with a sync facade

Reactive Streams APIs powered by Reactor, plus a synchronous facade for blocking use cases.

Pluggable JSON

A JSON abstraction with Jackson shipped as the default implementation.

Pluggable authorisation

Hooks let servers plug in Spring Security, MicroProfile JWT or custom auth instead of a built-in system.

Conformance tested

Dedicated server, client and auth conformance test suites are part of the build.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/modelcontextprotocol/java-sdk.git
    cd java-sdk
  2. Add the SDK to your project

    Follow the reference documentation for the Maven artifacts for MCP core/client/server, then build from source if contributing.

    git clone https://github.com/modelcontextprotocol/java-sdk.git
    cd java-sdk
    ./mvnw clean install -DskipTests
  3. Run the tests

    Verify a source build with the SDK's test suite.

    ./mvnw test
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains java-sdk?

It is maintained by modelcontextprotocol on GitHub (modelcontextprotocol/java-sdk), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under the MIT licence, which permits use, modification and redistribution, including commercially, with attribution.

Does it need a paid API key?

No API key is needed for the SDK itself — it is a protocol library; any LLM costs depend on the client application you connect.

How does it compare to the TypeScript or Python MCP SDKs?

Compared with the TypeScript or Python MCP SDKs, java-sdk's distinguishing focus is: the official Java SDK for building Model Context Protocol servers and clients. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/modelcontextprotocol/java-sdk (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Dev Tools

csharp-sdk

The official C# SDK for the Model Context Protocol — build MCP servers and clients in .NET

★ 4.6k starsApache-2.0
View guide →
Dev Tools

rust-sdk

rmcp: the official Rust SDK for the Model Context Protocol — tokio-based servers and clients

★ 4.0k starsNOASSERTION
View guide →
Dev Tools

ai

Vercel's AI SDK: the TypeScript toolkit for building AI apps and agents with any model provider

★ 27.2k starsNOASSERTION
View guide →
Dev Tools

fastapi_mcp

Expose your FastAPI endpoints as Model Context Protocol tools - with authentication - in a few lines of code.

★ 12.0k starsMIT
View guide →
Dev Tools

inspector

MCPJam Inspector: chat with, inspect, debug, and evaluate MCP servers across clients and models.

★ 2.2k starsApache-2.0
View guide →
Dev Tools

unitree_sdk2

Unitree's official C++ SDK v2 for programming its robots, with CMake examples and installable library.

★ 1.4k starsBSD-3-Clause
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if java-sdk is not the right fit.

Get java-sdk

Free and open — grab the source, star the repo, and start creating.