MCP STDIO to Streamable HTTP Adapter

MCP STDIO to Streamable HTTP Adapter

Connect to Streamable HTTP MCP Servers even if the MCP Client only supports STDIO.

21
Stars
8
Forks
0
Releases

Overview

Expands compatibility for MCP clients by acting as a STDIO-based MCP Server that relays requests to a Streamable HTTP MCP Server. The adapter enables clients that only support STDIO (or earlier transport methods) to communicate with Streamable HTTP MCP Servers, aligning with the MCP SPEC's new Streamable HTTP Transport. It can be deployed via npx or by building and running a local index.js; configure via environment variables URI (required), MCP_NAME (optional/enables differentiation when multiple servers), and BEARER_TOKEN (optional for Authorization header). It supports multiple provider configurations referencing the same MCP server with distinct env settings, showing up in Claude Desktop Home. For debugging, the MCP Inspector can be used through npm run inspector. Development workflow includes npm install, npm run build, and npm run watch. The project is designed to integrate Streamable HTTP MCP Servers into existing ecosystems like Claude Desktop and LibreChat.

Details

Owner
pyroprompts
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

STDIO-to-Streamable HTTP bridge

Relays MCP requests from STDIO-based clients to a Streamable HTTP MCP Server, enabling HTTP transport without rewriting clients.

Broad client compatibility

Enables MCP clients that only support STDIO to work with Streamable HTTP servers.

Env-based configuration

Configure connection with URI (required), MCP_NAME (optional for multiple servers), and BEARER_TOKEN (optional for Authorization header).

Multiple provider configurations

Configure several providers referencing the same MCP server with different environment variables.

Npx or local build deployment

Deploy via npx or build a local index.js to run the adapter in your environment.

Debugging with MCP Inspector

Use the MCP Inspector for debugging via the npm run inspector script.

Claude Desktop and LibreChat readiness

Provides example configurations to integrate with Claude Desktop and LibreChat environments.

Development workflow

Standard npm workflows: install, build, and watch for auto-rebuild during development.

Audience

MCP integratorsBridge STDIO MCP clients to Streamable HTTP MCP Servers to enable HTTP transport.
Claude Desktop usersConfigure Claude Desktop to access Streamable HTTP MCP Servers via this adapter.
LLM developersConnect LLMs to MCP servers via STDIO-to-HTTP bridging.

Tags

MCPSTDIOStreamable HTTPAdapterRelayClaude DesktopLibreChatInspector