ExMCP Test

An Elixir-based MCP server for testing and experimenting with the Model Context Protocol.

Install

Install and configure the MCP from https://github.com/y86/ex-mcp-test now. Follow the repository's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View source on GitHub

README

ExMCP Test Server

An MCP (Model Context Protocol) server implementation in Elixir that provides a test implementation for experimenting with the protocol.

Features

JSON-RPC 2.0 compliant server implementation
Standard MCP protocol methods supported
Pluggable validation and middleware pipeline
Schema-driven request/response validation
OpenRPC specification included

Architecture

The server is built using:

PhxJsonRpc for the RPC layer
ExJsonSchema for schema validation
Jason for JSON encoding/decoding

Usage

Run the server locally:

mix run --no-halt

Configuration

The best way to run the model is to generate a release with

mix release

and add it to to your claude_desktop_config.json:

{
  "mcpServers": {
    "ex-mcp-test": {
      "command": "path/to/your/realease/bin/my_app",
      "args": [
        "start"
      ]
    }
  }
}

Development

Requirements:

Elixir 1.14+
Mix

Install dependencies:

mix deps.get

Run tests:

mix test

API Documentation

The server implements the following MCP methods:

initialize - Initialize the server
notifications/initialized - Handle initialization notification

prompts/list - List available prompts
resources/list - List available resources

tools/list - List available tools
tools/call - Call a specific tool

The OpenRPC specification can be found in priv/static/mcp-openrpc.json.

License

This project is licensed under the MIT License - see the LICENSE file for details.