Servlet transports serialize McpError exceptions instead of JSON-RPC error envelopes

评估

调研方向

描述

Servlet transports serialize McpError exceptions instead of JSON-RPC error envelopes

Bug description

Some servlet transport error paths serialize McpError directly instead of returning a JSON-RPC error response envelope.

Because McpError extends RuntimeException, the response body can expose exception-shaped fields such as:

• stackTrace
• cause
• localizedMessage
• jsonRpcError

For example, on current main, a servlet transport validation error returns a body like this:

This is not the JSON-RPC response shape clients expect.

Environment

• MCP Java SDK version: current main
• Java version: 21
• Transport: servlet server transports

Steps to reproduce

1. Run an MCP server with a servlet transport.
2. Send a request that triggers a servlet transport error path.
3. Inspect the response body.

Expected behavior

The response body should look like:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Both application/json and text/event-stream required in Accept header"
  }
}

贡献指南

打开贡献指南

从这里开始

1. 先读完整个 Issue，再读项目的贡献指南。
2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
3. Fork 仓库，在一个分支上完成修改。
4. 提交 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

• [BUG] Unified agent on Bedrock Converse with no tools is unusable: an empty `toolConfig` is emitted and Bedrock rejects the request 未关闭
  bug untriaged

  难度 2/5 1-3 小时 新手友好度 84/100

  opensearch-project/ml-commons#5094 · 2026年9月22日 创建

• [Bug report] iceberg rest server load_table with refs fails precondition check "Cannot set metadata location with changes to table metadata: %s changes" for snapshots with statistics 未关闭
  bug

  难度 2/5 1-3 小时 新手友好度 85/100

  apache/gravitino#13452 · 2026年9月22日 创建

• Support Test Project Creation for New Projects 未关闭
  emitter:client:csharp feature

  难度 2/5 1-3 小时 新手友好度 72/100

  microsoft/typespec#12027 · 1 条评论 · 1 个 reaction · 2026年9月22日 创建

• Job worker stops polling silently when a poll throws an Error 未关闭
  affects/8.10 affects/8.9 component/clients kind/bug likelihood/mid severity/mid

  难度 2/5 1-3 小时 新手友好度 78/100

  camunda/camunda#63825 · 2026年9月22日 创建

• Two open-case totals on one screen: the Programs tile says 15,858 and the nav badge says 15,868 未关闭
  bug frontend maui-pilot

  难度 2/5 1-3 小时 新手友好度 72/100

  Taleef7/workwell#651 · 1 条评论 · 2026年9月22日 创建

更多 Java Issue