modelcontextprotocol / modelcontextprotocol/java-sdk
SEP-2243: HTTP Header Standardization for Streamable HTTP Transport
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- Java
- Star
- 3.7k
- Fork
- 1.1k
- Merge trung bình
- 1 ngày 15 giờ
- Pull request đã merge (30 ngày)
- 9
Mô tả
Description
Per SEP-2243 (HTTP Standard Headers), MCP clients MUST send the following HTTP headers on POST requests:
Mcp-Method: Set to the JSON-RPCmethodvalue from the request body (REQUIRED on every POST)Mcp-Name: Set fromparams.name(for tools/call, prompts/get) orparams.uri(for resources/read, resources/subscribe, resources/unsubscribe) when present
Context
The cxxmcp (C++ SDK) conformance testing revealed that the official conformance test suite's reference client (TypeScript SDK) does not send these headers, making the conformance suite self-contradictory. See:
- typescript-sdk#2176 — TypeScript SDK bug report
- conformance#323 — Conformance suite self-contradiction
- typescript-sdk#2178 — Fix PR for TypeScript SDK
Impact
Servers that enforce SEP-2243 (reject missing Mcp-Method with HTTP 400) are incompatible with clients that don't send these headers. This affects cross-SDK interoperability.
Request
Please implement Mcp-Method and Mcp-Name header support per SEP-2243 to ensure cross-SDK compatibility.
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Hướng nghiên cứu
Bắt đầu từ streamable HTTP transport client của Java SDK và theo dõi cách các yêu cầu POST được tạo. Sử dụng SEP-2243 và các trường request-body được mô tả ở đây để xác định các giá trị header; hoàn tất khi các yêu cầu POST áp dụng gửi Mcp-Method và Mcp-Name để các máy chủ thực thi tiêu chuẩn chấp nhận chúng.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- java
- Lĩnh vực
- api
- Loại issue
- Tính năng
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức độ hoạt động
- Sôi nổi
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 68/100