asmhatre/java-ai-agents
1
0
Fork 0
Code Activity

Add mcp-sdk-plain module: MCP server on the plain Java SDK 2.1.0 over stdio and Streamable HTTP, fat jar, wire transcripts and a Spring AI client

Browse Source 
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_017ic4b5oh78z7gcH6QkxafF
This commit is contained in:
Claude
2026-11-08 18:28:07 +00:00
parent 7c20ea1370
commit 58eaf4c2e1
29 changed files with 864 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
mcp-sdk-plain/README.md
+25
View File
@@ -0,0 +1,25 @@
# mcp-sdk-plain
Companion code for *Write an MCP Server with the Plain MCP Java SDK (No Spring): stdio and Streamable HTTP* on
[ankurm.com](https://ankurm.com). One tool/resource set, two transports, one fat jar. No Spring in the server.
```bash
mvn -pl mcp-sdk-plain package # runs the tests (rewrites output/01-04) and builds target/mcp-sdk-plain.jar
java -jar mcp-sdk-plain/target/mcp-sdk-plain.jar stdio # for Claude Desktop
java -jar mcp-sdk-plain/target/mcp-sdk-plain.jar http 8080 # Streamable HTTP on http://127.0.0.1:8080/mcp
bash mcp-sdk-plain/scripts/run-all.sh # regenerates output/01-06
bash mcp-sdk-plain/examples/spring-ai-client/run.sh # output/07, after package
```
| File | Role |
|---|---|
| `NoteTools` | Three tools: a happy path, a domain error returned as `isError`, and a handler that throws |
| `NoteResources` | A fixed resource (`notes://readme`) and a resource template (`notes://{name}`) |
| `PlainMcpServer` | Server name, capabilities, tools and resources, shared by both transports |
| `Main` | `stdio` or `http [port]`; stdout is left to the protocol, logs go to stderr |
| `HttpMain` | The SDK's Streamable HTTP servlet inside an embedded Jetty 12.1 (ee11) |
| `StdioTest`, `HttpTest`, `NoisyStdoutTest` | Each writes an `output/NN-*.txt` transcript and asserts the same facts |
| `scripts/raw-stdio.sh`, `scripts/curl-http.sh` | Drive the packaged jar with raw JSON-RPC and with curl (`output/05`, `06`) |
| `examples/spring-ai-client` | A standalone Spring Boot 4.1.2 + Spring AI 2.0.2 client that connects to the HTTP server (`output/07`) |
Verified against `io.modelcontextprotocol.sdk:mcp` **2.1.0**, Jetty **12.1.14**, JDK 25, JUnit 6.1.3.