ExMCP Test Server

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

GitHub

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.

Serveurs connexes