Ex MCP Test

🚀 ExMCP Test Server

An implementation of the Model Context Protocol (MCP) server in Elixir, offering a test version for protocol experimentation.

🚀 Quick Start

Local Deployment

To run the server locally, execute the following command:

mix run --no-halt

Configuration

It is recommended to run the model service by generating a release package:

mix release

Then, add the following configuration to your claude_desktop_config.json file:

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

✨ Features

• Server implementation compliant with the JSON-RPC 2.0 protocol.
• Support for standard MCP protocol methods.
• Pluggable authentication and middleware pipelines.
• Schema-based request/response validation.
• Inclusion of an OpenRPC specification file.

🔧 Technical Details

The server is built using the following technologies:

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

💻 Usage Examples

Basic Usage

Run the server locally:

mix run --no-halt

Advanced Usage

Generate a release package:

mix release

📚 Documentation

Development Guide

Project Requirements

• Elixir version 1.14 or higher.
• Mix tool.

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 notifications

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

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

The OpenRPC specification file is located at priv/static/mcp-openrpc.json.

📄 License

This project is open-source under the MIT License. For more details, please refer to the LICENSE file.