MCPheonix MCP Server

@jmanhype

Repository

Basic information

About MCPheonix MCP Server

A simplified implementation of the Model Context Protocol (MCP) server using Elixir's Phoenix Framework.

#mcpheonix#model-context-protocol #elixir#phoenix-framework

MCPheonix MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "your_server": {
      "command": "/path/to/executable",
      "args": [
        "arg1"
      ],
      "env": {
        "API_KEY": "value"
      },
      "tools": {
        "tool_name": {
          "description": "What it does",
          "parameters": [
            {
              "name": "param1",
              "type": "string",
              "description": "..."
            }
          ]
        }
      }
    }
  }
}

MCPheonix MCP Server 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 MCPheonix?

MCPheonix is an MCP server built on the Phoenix Framework (Elixir) that exposes Server-Sent Events and JSON-RPC endpoints for MCP clients. It manages multiple child MCP servers as supervised OTP processes, configured via a JSON file. This server is intended for developers who need to orchestrate specialized MCP sub-servers (e.g., Flux image generation, Dart task management) from a single Phoenix web server.

How to use MCPheonix?

Clone the repository, run mix deps.get, then mix phx.server to start the server on port 4001. Child MCP servers are defined in priv/config/mcp_servers.json and are automatically started at boot. Clients connect to GET /mcp/stream for SSE and POST /mcp/rpc for JSON-RPC 2.0 requests.

Key features of MCPheonix

Runs a Phoenix web server on port 4001 with SSE and JSON-RPC endpoints.
Manages child MCP servers as supervised OTP processes.
Supports Flux image generation and Dart task management as built-in child servers.
Accepts JSON configuration for adding arbitrary child MCP servers.
Event system powered by Broadway and GenStage.
Optional Cloudflare Durable Objects integration (experimental).

Use cases of MCPheonix

Centralized MCP server routing tool calls to multiple specialized child servers.
Managing Flux image generation as a subprocess via MCP.
Managing Dart task management as a subprocess via MCP.
Building custom MCP server orchestration with Elixir OTP supervision.

Frequently asked questions

What runtime dependencies does MCPheonix require?

Elixir >= 1.14, Erlang/OTP >= 25, Phoenix ~> 1.7, Node.js >= 18, and Python >= 3.9 (optional for Flux/Dart).

How do I add a new child MCP server?

Edit `priv/config/mcp_servers.json` with the server's command, arguments, environment variables, and tool definitions. The server starts automatically as a supervised process.

What MCP endpoints are available?

- `GET /mcp/stream` – SSE stream (returns `x-mcp-client-id` header). - `POST /mcp/rpc` – JSON-RPC 2.0 (requires `x-mcp-client-id` header).

Does MCPheonix support authentication?

No. The MCP endpoints currently have no authentication built-in.

What are the known limitations?

No authentication, SSE connections are not persisted across restarts, and the Cloudflare Durable Objects integration relies on a custom hex package that may not be publicly available.

Comments

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w