modelcontextprotocol/java-sdk
Watch
1
0
Fork
You've already forked java-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Mirror of https://github.com/modelcontextprotocol/java-sdk — The official Java SDK for Model Context Protocol servers and clients. Maintained in collaboration with Spring AI
399 commits 1 branch 50 tags 7.8 MiB
  • Java 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Daniel Garnier-Moiroux 080098e48c Client: handle server responses with Content-Length: 0 
- When the client sends `notification/initalized`, servers must respond
  with HTTP 202 and an empty body. We checked for the absence of a
  Content-Type header to verify whether the body was empty.
- However, some servers will send an empty body with a Content-Type
  header, and that header may have an unsupported, default type such as
  `text/html` or `text/plain`.
- Now we we also use the Content-Length header to check for an empty
  body. This header is optional in HTTP/2, so we do not make it our
  primary mechanism for detecting empty bodies.
- As part of this PR, we also move hard-coded HTTP header names to the
  HttpHeaders interface. While they are not defined by the MCP spec,
  they are used by it and are core to implementing the protocol.
  Therefore, they have their place in a core interface.
- Fixes #582

Signed-off-by: Daniel Garnier-Moiroux <git@garnier.wf>
2025-10-01 13:09:30 +02:00
.github Add CI GitHub Action and rename snapshot publish workflow 2025-03-18 13:37:49 +01:00
.mvn/wrapper initial 2024-12-06 16:41:17 +01:00
mcp Next development version 2025-09-18 19:28:56 +02:00
mcp-bom Next development version 2025-09-18 19:28:56 +02:00
mcp-core Client: handle server responses with Content-Length: 0 2025-10-01 13:09:30 +02:00
mcp-json Next development version 2025-09-18 19:28:56 +02:00
mcp-json-jackson2 Next development version 2025-09-18 19:28:56 +02:00
mcp-spring Client: handle server responses with Content-Length: 0 2025-10-01 13:09:30 +02:00
mcp-test refactor: improve MCP server resilience and error handling (#579) 2025-09-30 11:10:04 +02:00
.gitattributes initial 2024-12-06 16:41:17 +01:00
.gitignore Rename modules, update .gitignore 2024-12-10 18:46:49 -05:00
CODE_OF_CONDUCT.md Add Contributing Guidelines and Code of Conduct 2025-05-16 11:47:39 +02:00
CONTRIBUTING.md Add note about force pushes 2025-05-16 11:47:39 +02:00
LICENSE Update license text and GH actions 2025-01-28 14:36:31 +01:00
migration-0.8.0.md refactor: introduce session-based architecture for MCP server (#31) 2025-03-20 21:49:51 +01:00
mvnw initial 2024-12-06 16:41:17 +01:00
mvnw.cmd initial 2024-12-06 16:41:17 +01:00
pom.xml Next development version 2025-09-18 19:28:56 +02:00
README.md Enhance README with project badges 2025-09-08 15:30:51 +02:00
SECURITY.md Add Contributing Guidelines and Code of Conduct 2025-05-16 11:47:39 +02:00

README.md

MCP Java SDK

License Build Status Maven Central Java Version

A set of projects that provide Java SDK integration for the Model Context Protocol. This SDK enables Java applications to interact with AI models and tools through a standardized interface, supporting both synchronous and asynchronous communication patterns.

📚 Reference Documentation

MCP Java SDK documentation

For comprehensive guides and SDK API documentation

Spring AI MCP documentation

Spring AI MCP extends the MCP Java SDK with Spring Boot integration, providing both client and server starters. Bootstrap your AI applications with MCP support using Spring Initializer.

Development

Building from Source

./mvnw clean install -DskipTests

Running Tests

To run the tests you have to pre-install Docker and npx.

./mvnw test

Contributing

Contributions are welcome! Please follow the Contributing Guidelines.

Team

  • Christian Tzolov
  • Dariusz Jędrzejczyk

Links

License

This project is licensed under the MIT License.