mcp-http-to-stdio

# MCP HTTP-to-STDIO Bridge A Python bridge utility that enables Claude Desktop to connect to HTTP-based MCP (Model Context Protocol) servers via stdio transport. ## Overview Claude Desktop uses stdio (stdin/stdout) to communicate with MCP servers, but many MCP servers expose HTTP endpoints. This bridge translates between the two protocols, allowing Claude Desktop to use HTTP-based MCP servers. **Architecture:** ``` Claude Desktop (stdio/JSON-RPC) ←→ mcp-http-to-stdio (bridge) ←→ HTTP MCP Server ``` ## Features - ✅ **Protocol Translation**: Converts stdio JSON-RPC to HTTP POST requests - ✅ **Authentication**: Supports custom header-based authentication - ✅ **Connection Pooling**: Optimized HTTP connections with keep-alive and retry logic - ✅ **Error Handling**: Comprehensive error responses for network, auth, and server errors - ✅ **Logging**: File and stderr logging for debugging - ✅ **Performance**: Tracks request timing and logs slow requests ## Prerequisites - Python 3.8+ - An HTTP-based MCP server to connect to - Claude Desktop ## Installation ### From PyPI (Recommended) ```bash pip install mcp-http-to-stdio ``` This installs the package globally and makes the `mcp-http-to-stdio` command available system-wide. ### From Source ```bash git clone https://github.com/your-org/agentic-enterprise.git cd agentic-enterprise/packages/mcp-http-to-stdio pip install -e . ``` ## Configuration ### Claude Desktop Config File Location - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` - **Linux**: `~/.config/Claude/claude_desktop_config.json` ### Basic Configuration ```json { "mcpServers": { "my-http-mcp-server": { "command": "mcp-http-to-stdio", "args": [ "--url", "http://localhost:8080/mcp" ], "env": { "AUTH_TOKEN": "your-auth-token-here" } …