Skip to content

Protocol Version Incompatibility with Claude Desktop #100

@pezzking

Description

@pezzking

Issue

The kubernetes-mcp-server version 0.0.36 is incompatible with Claude Desktop v0.9.3's MCP client, while version 0.0.35 works correctly. The issue appears to be related to protocol version handling.

Environment

  • Claude Desktop: v0.9.3
  • Operating System: macOS
  • Architecture: ARM64 (Apple Silicon)
  • kubernetes-mcp-server: v0.0.36 (failing) / v0.0.35 (working)

Details

  1. Claude client sends initialization with protocol version: "2024-11-05"
  2. Server v0.0.36 responds with protocol version: "2025-03-26"
  3. Server v0.0.35 responds with protocol version: "2024-11-05"

Reproduction Steps

  1. Install kubernetes-mcp-server@0.0.36
  2. Configure Claude Desktop v0.9.3 to use the server
  3. Start Claude
  4. Observe server logs showing protocol mismatch and early disconnection

Logs

2025-05-29T08:29:18.696Z [kubernetes] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
2025-05-29T08:29:19.814Z [kubernetes] [info] Message from server: {"jsonrpc":"2.0","id":0,"result":{"protocolVersion":"2025-03-26",...}}
2025-05-29T08:29:19.815Z [kubernetes] [info] Server transport closed unexpectedly

Workaround

Using version 0.0.35 of the server, which maintains protocol version compatibility with Claude Desktop's MCP client.

Recommendation

Consider either:

  1. Making v0.0.36 backward compatible with protocol version "2024-11-05"
  2. Or documenting the protocol version requirements more explicitly
  3. Or implementing protocol version negotiation between client and server

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions