Skip to content

[Windows] Handshake failure with Codex MCP when show_banner=True #25

@colpoe2

Description

@colpoe2

Description:
Environment:

OS: Windows

FastMCP Version: 3.1.0

Client: Codex MCP (stdio)

Issue:
The MCP client for grok-search fails to start when the banner is enabled. The connection closes during the initialization phase, resulting in a handshake failure.

Error Message:
MCP client for 'grok-search' failed to start: MCP startup failed: handshaking with MCP server failed: connection closed: initialize response

Observations:

The error occurs specifically when the banner is enabled during startup.

Setting show_banner=False resolves the issue and restores normal operation.

The server works as expected with Claude Code.

Suggested Fix:
In src/grok_search/server.py at line 808, change the initialization from:

Python
mcp.run(transport="stdio")
to:

Python
mcp.run(transport="stdio", show_banner=False)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions