MCPgee
MCPgee
MCPgeeMCPgee

McPhoenix

v1.0.0•Developer Tools•stable

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

mcphoenixmcpai-integration
Share:
67
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is McPhoenix?

McPhoenix is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to simplified implementation of the model context protocol (mcp) server using elixir's phoenix framework.

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

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A simplified implementation of the Model Context Protocol (M

Use Cases

Implement MCP servers using Elixir's Phoenix.
Build scalable MCP implementations with Elixir.
Develop protocol-compliant servers using Phoenix Framework.
jmanhype

Maintainer

LicenseMIT
Languageelixir
Versionv1.0.0
UpdatedMar 25, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcphoenix

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use McPhoenix

MCPhoenix is an Elixir/Phoenix Framework implementation of the Model Context Protocol server that acts as a gateway, managing child MCP servers (such as Flux image generation and Dart task management) under OTP supervision. It exposes a JSON-RPC 2.0 API over HTTP with Server-Sent Events streaming, letting AI clients connect once and dispatch tool calls to any of the registered child servers. Developers use it as a foundation for building fault-tolerant, scalable MCP backends in Elixir.

Prerequisites

  • Elixir >= 1.14 and Erlang/OTP >= 25 installed
  • Node.js >= 18 (required for JavaScript-based child MCP servers)
  • Python >= 3.9 (required for Flux image generation integration)
  • API keys for optional child servers: BFL_API_KEY (Flux), DART_TOKEN (Dart), CLOUDFLARE_API_TOKEN (Cloudflare Workers)
  • An MCP-compatible client that supports SSE transport
1

Clone the repository

Clone MCPhoenix from GitHub and enter the project directory.

git clone https://github.com/jmanhype/MCPhoenix.git
cd MCPhoenix
2

Install Elixir dependencies

Fetch all Mix dependencies required by the Phoenix application.

mix deps.get
3

Configure child MCP servers

Edit priv/config/mcp_servers.json to define which child servers MCPhoenix should manage. Add the path, args, and any env vars for each child server (e.g. Flux, Dart).

{
  "mcpServers": {
    "flux": {
      "command": "/usr/bin/python3",
      "args": ["flux_server.py"],
      "env": { "BFL_API_KEY": "your_bfl_api_key" }
    },
    "dart": {
      "command": "node",
      "args": ["dart_server.js"],
      "env": { "DART_TOKEN": "your_dart_token" }
    }
  }
}
4

Start the Phoenix server

Launch MCPhoenix. It starts on port 4001 by default and spawns all configured child servers as supervised OTP processes.

mix phx.server
5

Connect your MCP client via SSE

Clients connect by opening a GET request to /mcp/stream to receive an x-mcp-client-id header, then send JSON-RPC 2.0 tool call requests to /mcp/rpc including that client ID in the headers.

McPhoenix Examples

Client configuration

Configure an MCP client to connect to a locally running MCPhoenix instance using HTTP/SSE transport.

{
  "mcpServers": {
    "mcphoenix": {
      "type": "sse",
      "url": "http://localhost:4001/mcp/stream"
    }
  }
}

Prompts to try

After connecting through an MCP client, try these prompts to exercise child server tools.

- "Generate an image of a sunset over the ocean using Flux."
- "List all available tools registered in this MCP gateway."
- "Create a new Dart task titled 'Review PR #42'."
- "What child MCP servers are currently running and healthy?"
- "Call the Flux image generation tool with prompt: a futuristic city at dusk."

Troubleshooting McPhoenix

Child server fails to start and MCPhoenix logs 'process exited'

Check the command path in mcp_servers.json is absolute and executable. Verify Node.js or Python is installed at the expected path and the required API keys are set in the env block.

SSE connection at /mcp/stream closes immediately

Confirm mix phx.server started without compile errors and is listening on port 4001. Try curl -N http://localhost:4001/mcp/stream to test the raw SSE stream from the terminal.

JSON-RPC calls to /mcp/rpc return 400 or 'invalid client id'

You must first open /mcp/stream and read the x-mcp-client-id value from the response headers, then include that value in every subsequent POST to /mcp/rpc as the x-mcp-client-id header.

Frequently Asked Questions about McPhoenix

What is McPhoenix?

McPhoenix is a Model Context Protocol (MCP) server that simplified implementation of the model context protocol (mcp) server using elixir's phoenix framework. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install McPhoenix?

Follow the installation instructions on the McPhoenix GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with McPhoenix?

McPhoenix works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is McPhoenix free to use?

Yes, McPhoenix is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

McPhoenix Alternatives — Similar Developer Tools Servers

Looking for alternatives to McPhoenix? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcphoenix": { "command": "npx", "args": ["-y", "mcphoenix"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use McPhoenix?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides