MCP.so
Sign In

MCP stdio adapter

@jrderuiter

Basic information

Category

Developer Tools

Transports

stdio

Author

jrderuiter

About MCP stdio adapter

Expose a remote MCP server (HTTP) as a local stdio MCP server.

#mcp-stdio-adapter#remote-server#stdio-adapter

MCP stdio adapter config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

MCP stdio adapter tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP stdio adapter?

MCP stdio adapter is a proxy that exposes a remote MCP server (using streamable HTTP) as a local stdio-based MCP server. It is designed for applications—such as the Zed editor—that only support the stdio transport for MCP, enabling them to use remote MCP servers.

How to use MCP stdio adapter?

Run the adapter from the command line by setting the SERVER_ADDRESS environment variable to your remote server’s URL and using either uv run fastmcp run main.py or a Docker container (jrderuiter/mcp-stdio-adapter). In Zed, add a context_servers entry with the appropriate command and environment variables (native or Docker).

Key features of MCP stdio adapter

  • Converts remote HTTP MCP servers to local stdio.
  • Supports both native Python (uv) and Docker runtimes.
  • Simple environment variable configuration (SERVER_ADDRESS).
  • Ready-to-use in Zed editor with minimal setup.
  • No modification required to the remote server.

Use cases of MCP stdio adapter

  • Using remote MCP servers in editors that only support stdio (e.g., Zed).
  • Running an HTTP MCP server locally via a stdio interface for CLI tools.
  • Wrapping a cloud-hosted MCP server for any stdio-only MCP client.

Frequently asked questions

1

What exactly does this adapter do?

It acts as a bridge: your local editor communicates over stdio with the adapter, which then forwards requests as HTTP to the remote MCP server.

2

What software do I need to run the adapter?

You need either Python with `uv` and `fastmcp`, or Docker. No additional dependencies are required on the remote server.

3

Can I use the adapter without Docker?

Yes, use the `uv run fastmcp run main.py` command; Docker is an alternative packaging.

4

Does the adapter work with any MCP server?

Yes, as long as the remote server speaks streamable HTTP (the MCP HTTP transport). The adapter does not modify the remote server’s tools or resources.

5

How do I configure the adapter in Zed?

Add a `context_servers` entry with the `command` and `env` as shown in the README, setting `SERVER_ADDRESS` to your remote server’s URL.

Comments

More Developer Tools MCP servers