MCP ExplorerExplorer

Mcp Proxy Elixir

@tidewave-aion 22 days ago
101 Apache-2.0
FreeCommunity
AI Systems
A proxy to use SSE MCPs from STDIO clients

Overview

What is Mcp Proxy Elixir

mcp_proxy_elixir is an escript designed to connect STDIO-based MCP clients to HTTP (SSE) based MCP servers, specifically compatible with the MCP specification dated 2024-11-05.

Use cases

Use cases include integrating legacy STDIO clients with modern HTTP-based MCP servers, debugging communication issues between clients and servers, and facilitating real-time data streaming in applications.

How to use

To use mcp_proxy_elixir, install it via the command ‘mix escript.install hex mcp_proxy’. Configure your MCP client by specifying the command to run the proxy and the SSE URL in the client’s configuration file.

Key features

Key features include the ability to connect STDIO clients to SSE MCP servers, support for debugging through logging, and easy installation via Mix.

Where to use

mcp_proxy_elixir can be used in environments where STDIO-based clients need to communicate with HTTP-based MCP servers, such as in web applications or real-time data processing systems.

Content

[!WARNING]
This project is deprecated. Use the Rust MCP Proxy instead, which is easier to install if you don’t already have Elixir.

mcp-proxy

An Elixir escript for connecting STDIO based MCP clients to HTTP (SSE) based MCP servers.

Note: At the moment this only works with MCP servers that use the 2024-11-05 specification.

Installation

$ mix escript.install hex mcp_proxy

The escript is installed into your HOME’s .mix directory: /path/to/home/.mix/escripts/mcp-proxy.

Usage

If you have an SSE MCP server available at http://localhost:4000/tidewave/mcp, a client like Claude Desktop would then be configured as follows.

On macos/Linux

You will also need to know the location of the escript executable, so run which escript before to get the value of “path/to/escript”:

{
  "mcpServers": {
    "my-server": {
      "command": "/path/to/escript",
      "args": [
        "/$HOME/.mix/escripts/mcp-proxy",
        "http://localhost:4000/tidewave/mcp"
      ]
    }
  }
}

Remember to replace $HOME by your home directory, such as “/Users/johndoe”.

On Windows

Remember to replace $HOME by your home directory, such as “c:\Users\johndoe”.

Configuration

mcp-proxy either accepts the SSE URL as argument or using the environment variable SSE_URL. For debugging purposes, you can also pass --debug, which will log debug messages on stderr.

Other supported flags:

  • --max-disconnected-time the maximum amount of time for trying to reconnect while disconnected. When not set, defaults to infinity.
  • --receive-timeout the maximum amount of time to wait for an individual reply from the MCP server in milliseconds. Defaults to 60000 (60 seconds).

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers