Stdio Gateway

•
9
•

Relays requests between local MCP clients and remote HTTP MCP servers, supporting diverse authentication methods and ensuring robust connectivity.

mcp-stdio functions as a versatile gateway, presenting remote MCP servers as locally running services to clients like Claude Desktop and Claude Code. It seamlessly bridges stdio-based client interactions with HTTPS-based remote MCP servers, handling complex streamable HTTP and SSE transports. The tool boasts comprehensive OAuth 2.1 client capabilities, including PKCE, dynamic client registration, and proactive token management, alongside support for bearer tokens and custom headers. It enhances reliability with retry mechanisms, streaming resilience, and intelligent handling of API pagination and errors, making remote MCP server integration straightforward and dependable.

Características Principales

01Cancellation-aware filtering and SSE in-flight error synthesis for robust client interaction
02Comprehensive OAuth 2.1 client with PKCE, dynamic registration, and extensive RFC support
03Proactive OAuth token refresh, step-up authorization, and cold-start (`--oauth-eager`) for smooth user experience
045 GitHub stars
05Supports both Streamable HTTP and legacy SSE MCP transports with streaming resilience and auto-reconnect
06Automatic pagination for list endpoints and intelligent HTTP 429/503 handling with `Retry-After`

Casos de Uso

01Connect AI agent clients like Claude Desktop or Claude Code to remote MCP servers
02Integrate with MCP servers that require advanced OAuth 2.1 authentication flows, including headless environments via Device Authorization Grant
03Bridge existing stdio-based MCP clients to HTTP/HTTPS MCP services using bearer tokens or custom headers