MCP ExplorerExplorer

Mcp Stdio Adapter

@jrderuiteron 12 days ago
1 MIT
FreeCommunity
AI Systems
Expose a remote MCP server (HTTP) as a local stdio MCP server.

Overview

What is Mcp Stdio Adapter

mcp-stdio-adapter is an adapter that allows you to expose a remote MCP server (streamable HTTP) as a local stdio MCP server, enabling the use of remote MCP servers in applications that only support stdio.

Use cases

Use cases for mcp-stdio-adapter include integrating remote MCP servers into local development workflows, enhancing productivity in coding environments, and facilitating remote server interactions in applications like Zed.

How to use

To use mcp-stdio-adapter, you can run it from the command line by setting the SERVER_ADDRESS environment variable to your MCP server’s address. Alternatively, you can use Docker to run the adapter. In applications like Zed, you can configure the proxy in your settings file by adding a context_servers entry.

Key features

Key features of mcp-stdio-adapter include the ability to connect to remote MCP servers via HTTP, support for local stdio applications, and ease of integration with tools like Zed.

Where to use

mcp-stdio-adapter is particularly useful in development environments where applications only support standard input/output, allowing developers to leverage remote MCP servers seamlessly.

Content

MCP stdio adapter

Adapter that allows you to expose a remote MCP servers (streamable HTTP) as a local stdio MCP server. Useful for using remote MCP servers in applications that only support stdio (such as Zed).

graph LR
    remote(Remote server)
	adapter[This adapter]
	editor(Local editor)

  editor -->|stdio| adapter
	adapter -->|HTTP| remote

Usage

From the command line

You can run the proxy as follows:

SERVER_ADDRESS=http://<address-of-your-mcp-server> uv run fastmcp run main.py

or using Docker:

docker run --rm -it -e SERVER_ADDRESS=http://<your-server-address> jrderuiter/mcp-stdio-adapter

In Zed

For Zed, you can configure the proxy by adding the following context_servers entry in your settings file:

or using Docker:

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

Author

Julian de Ruiter

Tools

No tools

Comments