MCP-Connect

Exposes local stdio-based MCP (Model Context Protocol) servers as HTTP/HTTPS endpoints, enabling cloud-based AI services to invoke local tools without direct network access. Implements a reverse-proxy pattern that translates HTTP requests into stdio protocol messages, manages bidirectional communication channels, and handles protocol serialization/deserialization between HTTP and MCP formats.

Translates incoming HTTP requests into MCP-compliant protocol messages and routes them to the appropriate local stdio server, then marshals responses back to HTTP format. Handles MCP message framing, request/response correlation, and protocol version negotiation to ensure compatibility between HTTP clients and stdio-based MCP servers.

Manages the startup, health monitoring, and graceful shutdown of local stdio-based MCP servers. Spawns child processes with proper stdio piping, monitors process health, detects crashes, and implements reconnection logic to maintain availability of the HTTP bridge.

Exposes the MCP bridge as an HTTP/HTTPS server with configurable endpoints for tool invocation, resource access, and server introspection. Implements standard HTTP request/response handling, content negotiation, error responses, and optional TLS termination for secure communication with cloud AI services.

Queries the local MCP server to discover available tools, their schemas, parameters, and descriptions, then exposes this metadata via HTTP endpoints. Enables cloud AI services to dynamically learn what tools are available and how to invoke them without hardcoding tool definitions.

Manages multiple concurrent HTTP requests to a single local MCP server by multiplexing them over the stdio channel using request IDs and async message correlation. Prevents head-of-line blocking and ensures that slow tool invocations don't block other concurrent requests.

Catches errors from the local MCP server (tool execution failures, schema errors, protocol violations) and normalizes them into consistent HTTP error responses with appropriate status codes and error details. Prevents raw MCP errors from leaking to cloud AI services and provides actionable error information.

Manages bridge configuration including MCP server executable path, HTTP port, TLS settings, logging levels, and environment variables. Supports configuration via command-line arguments, environment variables, and optional config files, enabling flexible deployment across different environments.