ExMCP Test Server

Um servidor MCP baseado em Elixir para testar e experimentar o Model Context Protocol.

Documentação

ExMCP Test Server

Uma implementação de servidor MCP (Model Context Protocol) em Elixir que fornece uma implementação de teste para experimentar o protocolo.

Recursos

  • Implementação de servidor compatível com JSON-RPC 2.0
  • Métodos padrão do protocolo MCP suportados
  • Pipeline de validação e middleware plugável
  • Validação de requisição/resposta orientada por esquema
  • Especificação OpenRPC incluída

Arquitetura

O servidor é construído usando:

  • PhxJsonRpc para a camada RPC
  • ExJsonSchema para validação de esquema
  • Jason para codificação/decodificação JSON

Uso

Execute o servidor localmente:

mix run --no-halt

Configuração

A melhor maneira de executar o modelo é gerar um release com

mix release

e adicione-o ao seu claude_desktop_config.json:

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

Desenvolvimento

Requisitos:

  • Elixir 1.14+
  • Mix

Instale as dependências:

mix deps.get

Execute os testes:

mix test

Documentação da API

O servidor implementa os seguintes 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

A especificação OpenRPC pode ser encontrada em priv/static/mcp-openrpc.json.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.