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
277 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
Christian Tzolov e610d853f9 feat: Add customizable URI template manager factory to MCP server 
Implement URI template functionality for MCP resources, allowing dynamic
resource URIs with variables in the format {variableName}.

- Enable resource URIs with variable placeholders (e.g., "/api/users/{userId}")
- Automatic extraction of variable values from request URIs
- Validation of template arguments in completions
- Matching of request URIs against templates

- Add new URI template management interfaces and implementations
- Enhanced resource template listing to include templated resources
- Updated resource request handling to support template matching
- Test coverage for URI template functionality

- Adding a configurable uriTemplateManagerFactory field to both AsyncSpecification and SyncSpecification classes
- Adding builder methods to allow setting a custom URI template manager factory
- Modifying constructors to pass the URI template manager factory to the server implementation
- Updating the server implementation to use the provided factory
- Add bulk registration methods for async completions

Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
2025-04-29 07:11:39 +03: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 feat: Add customizable URI template manager factory to MCP server 2025-04-29 07:11:39 +03:00
mcp-bom Next development version 2025-04-10 18:06:46 +02:00
mcp-spring feat: Add customizable URI template manager factory to MCP server 2025-04-29 07:11:39 +03:00
mcp-test Fix javadoc references and formatting (#149) 2025-04-23 17:03:10 +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
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 feat(mcp): resolve absolute and relative message endpoint URIs (#150) 2025-04-18 14:52:50 +02:00
README.md feat(mcp): resolve absolute and relative message endpoint URIs (#150) 2025-04-18 14:52:50 +02:00

README.md

MCP Java SDK

Build Status

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, visit the MCP Java SDK Reference 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:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a Pull Request

Team

  • Christian Tzolov
  • Dariusz Jędrzejczyk

Links

License

This project is licensed under the MIT License.