ExMCP Test Server

Un servidor MCP basado en Elixir para probar y experimentar con el Model Context Protocol.

Documentación

ExMCP Test Server

Una implementación de servidor MCP (Model Context Protocol) en Elixir que proporciona una implementación de prueba para experimentar con el protocolo.

Características

  • Implementación de servidor compatible con JSON-RPC 2.0
  • Métodos estándar del protocolo MCP soportados
  • Pipeline de validación y middleware conectable
  • Validación de solicitudes/respuestas basada en esquemas
  • Especificación OpenRPC incluida

Arquitectura

El servidor está construido usando:

  • PhxJsonRpc para la capa RPC
  • ExJsonSchema para la validación de esquemas
  • Jason para codificación/decodificación JSON

Uso

Ejecuta el servidor localmente:

mix run --no-halt

Configuración

La mejor manera de ejecutar el modelo es generar una versión con

mix release

y añádelo a tu claude_desktop_config.json:

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

Desarrollo

Requisitos:

  • Elixir 1.14+
  • Mix

Instalar dependencias:

mix deps.get

Ejecutar pruebas:

mix test

Documentación de la API

El servidor implementa los siguientes métodos MCP:

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

La especificación OpenRPC se puede encontrar en priv/static/mcp-openrpc.json.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.