mcp-sse-shim

MCP.Pizza Chef: langflow-ai

mcp-sse-shim is an MCP server adapter that allows clients to connect to an MCP Server-Sent Events (SSE) endpoint through standard input/output (stdio). It acts as a lightweight shim to bridge SSE-based MCP servers with clients that communicate over stdio, enabling real-time streaming of structured context and events. The shim supports environment variable configuration for flexible backend URL targeting and debugging. This makes it ideal for integrating MCP SSE servers into environments or workflows that rely on stdio communication, enhancing interoperability and real-time data flow in AI-enhanced applications.

Use This MCP server To

Connect MCP clients to SSE servers via stdio Stream real-time MCP events in stdio-based workflows Bridge SSE MCP servers with stdio communication tools Enable debugging of MCP SSE connections via env vars Integrate MCP SSE servers into terminal-based apps

README

mcp-sse-shim

Allows you to connect to an sse mcp server via stdio

Run:

uvx mcp-sse-shim

Optionally set these env vars:

MCP_HOST = os.getenv("MCP_HOST", "http://localhost:7860")
BASE_URL = f"{MCP_HOST}"
BACKEND_URL_SSE = f"{BASE_URL}/api/v1/mcp/sse"
BACKEND_URL_MSG = f"{BASE_URL}/api/v1/mcp/"
DEBUG = os.getenv("DEBUG", "false").lower() == "true"

mcp-sse-shim FAQ

How do I run the mcp-sse-shim server?

Run the command 'uvx mcp-sse-shim' in your terminal to start the shim.

How can I configure the backend URL for mcp-sse-shim?

Set the MCP_HOST environment variable to your MCP server URL; the shim uses this to build backend SSE and message URLs.

What environment variables does mcp-sse-shim support?

It supports MCP_HOST for the server URL and DEBUG to enable debug logging (set to 'true' or 'false').

Can mcp-sse-shim be used for debugging MCP SSE connections?

Yes, setting DEBUG=true enables detailed logging to help troubleshoot connection issues.

Does mcp-sse-shim support secure connections?

It supports any MCP SSE server accessible via the URL set in MCP_HOST, including HTTPS endpoints.

Is mcp-sse-shim compatible with multiple MCP server implementations?

Yes, it works with any MCP SSE server following the MCP protocol, regardless of the underlying LLM provider like OpenAI, Claude, or Gemini.

How does mcp-sse-shim handle real-time event streaming?

It connects to the MCP SSE endpoint and relays events through stdio for real-time processing by clients.

Can I use mcp-sse-shim in automated workflows?

Yes, it is designed to integrate MCP SSE servers into stdio-based automation and scripting environments.