Java MCP Server examples are incomplete and non-runnable

未關閉

#687 建立於 2025年11月25日 2 則留言 3 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 3/5
預估耗時: 1-2 天
新手友好度: 45/100

Issue 類型: 文件
描述清晰度: 基本清楚
活躍度: 停滯
技術堆疊: java
領域: documentation

研究方向

從 https://modelcontextprotocol.io/sdk/java/mcp-server 的 Java MCP Server 文件開始，檢視 WebFlux stateless 程式碼片段、其 Maven 相依性，以及缺少的設定或進入點。完成的標準是：文件包含一個完整的最小 Java 11 Hello World 範例，具備可解析的相依性和足夠的設定，無需進一步研究即可複製、編譯和執行。

由索引模型根據 Issue 內容生成。

描述

documentation P3

Bug description

The current documentation examples for the Java MCP Server are incomplete and non-functional. Dependencies referenced in the code snippets cannot be resolved, and critical components (e.g., main class, configuration, or entry point) are missing. There is no working “Hello World” example to verify basic setup and functionality, making it impossible for new users to get started.

Environment

Spring MCP version: 0.16.0 with webflux implementation
Java version: Java 11
Build tool: Maven
IDE: Eclipse

Steps to reproduce

Go to the official Spring MCP documentation (e.g., https://modelcontextprotocol.io/sdk/java/mcp-server).
Copy the provided code snippets with webflux stateless into a new Java project.
Attempt to compile or run the code.
Observe unresolved dependencies

Expected behavior

The documentation should provide a complete, minimal, and runnable Java example that:

Includes all necessary dependencies (with Maven/Gradle snippets).
Contains a working demo example.
Demonstrates a basic “Hello World” endpoint or service.
Can be copied, pasted, and run immediately without additional research or guessing.
Minimal Complete Reproducible example

主要語言: Java
星號: 3.7k
分支: 1.1k
平均合併: 1 天 15 小時
30 天內合併 PR: 9

貢獻指南

開啟貢獻指南

從這裡開始

先讀完整個 Issue，再讀專案的貢獻指南。
在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
Fork 儲存庫，在一個分支上完成修改。
送出 Pull Request，並在描述裡引用這個 Issue 編號。

modelcontextprotocol/java-sdk 的其他 Issue

SSE client silently truncates a data: line at U+2028/U+2029/U+0085, then fails with "Error parsing JSON-RPC message" 未關閉

area/transport bug P2

難度 2/5 1-3 小時新手友好度 88/100

modelcontextprotocol/java-sdk#1136 · 2026年9月18日建立
Client request handlers that complete empty send no JSON-RPC response 未關閉

area/client bug P2

難度 2/5 1-3 小時新手友好度 84/100

modelcontextprotocol/java-sdk#1124 · 1 則留言 · 2026年9月3日建立
ServerCapabilities.logging is added unconditionally, overriding the caller's explicit capabilities 未關閉

bug P2 ready for work

難度 2/5 1-3 小時新手友好度 68/100

modelcontextprotocol/java-sdk#1086 · 1 則留言 · 2026年8月11日建立
Reject listRoots if not supported by client, without sending any request 未關閉

enhancement good first issue P3

難度 2/5 1-3 小時新手友好度 82/100

modelcontextprotocol/java-sdk#1067 · 2026年7月19日建立
StdioClientTransport missing explicit UTF-8 charset in InputStreamReader (same issue as #295, but on client side) 未關閉

bug P2 ready for work

難度 2/5 1-3 小時新手友好度 74/100

modelcontextprotocol/java-sdk#898 · 1 則留言 · 2026年4月2日建立

查看 modelcontextprotocol/java-sdk 的全部 Issue

相似的 Issue

chore: aspectjweaver(EPL-2.0)와 AGPL-3.0 호환성 정리 未關閉

documentation

難度 2/5 1-3 小時新手友好度 65/100

inu-appcenter/memorIN-backend#288 · 2026年9月24日建立
Vulnerability Nessus 12085 - Apache Tomcat Default Files (with killbill/killbill:0.24.21) 未關閉

難度 2/5 1-3 小時新手友好度 65/100

killbill/killbill#2314 · 1 則留言 · 2026年9月24日建立
Work list, Cases and Compliance overlap, and nothing says which one to use 未關閉

frontend maui-pilot pilot-ask question

難度 2/5 1-3 小時新手友好度 75/100

Taleef7/workwell#698 · 2026年9月24日建立
[Bug][UI] Replace the status of the button in the Sessions Tab 未關閉

難度 2/5 1-3 小時新手友好度 75/100

Netcracker/qubership-integration-platform#918 · 2026年9月24日建立
executions.Query — startDate and timeRange filters are sent with inverted comparison operators 未關閉

area/plugin

難度 2/5 1-3 小時新手友好度 75/100

kestra-io/plugin-kestra#190 · 2026年9月24日建立

更多 Java Issue