MS

MCP STDIO to Streamable HTTP Adapter

Created 5 months ago

Integrate any MCP Client with Streamable HTTP MCP Servers.

development documentation public

What is MCP STDIO to Streamable HTTP Adapter?

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

Documentation

mcp-stdio-to-streamable-http-adapter

Installation

To add OpenAI to Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Env Vars

  • URI: The URL of the Streamable HTTP MCP Server. This is required.
  • MCP_NAME: The name of the MCP Server. This is optional.
  • BEARER_TOKEN: The Bearer token for the Streamable HTTP MCP Server. This is optional.

Configuration

You can use it via npx in your Claude Desktop configuration like this:

{
  "mcpServers": {
    "my-saas-app-development": {
      "command": "npx",
      "args": ["@pyroprompts/mcp-stdio-to-streamable-http-adapter"],
      "env": {
        "URI": "http://localhost:3002/mcp",
        "MCP_NAME": "local-custom-streamable-http-adapter"
      }
    }
  }
}

Or, if you clone the repo, you can build and use in your Claude Desktop configuration like this:

{
  "mcpServers": {
    "my-saas-app-development": {
      "command": "node",
      "args": ["/path/to/mcp-stdio-to-streamable-http-adapter/build/index.js"],
      "env": {
        "URI": "http://localhost:3002/mcp",
        "MCP_NAME": "local-custom-streamable-http-adapter"
      }
    }
  }
}
```\n\n### Development
Install dependencies:
```bash
npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch
```\n\n### Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).

Server Config

{
  "mcpServers": {
    "mcp-stdio-to-streamable-http-adapter-server": {
      "command": "npx",
      "args": [
        "mcp-stdio-to-streamable-http-adapter"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: ferrants
Category: community
License: MIT
Tags:
development documentation public