Coin Flip MCP Server

Coin Flip MCP Server

Um servidor MCP que fornece lançamentos de moeda verdadeiramente aleatórios usando a API de aleatoriedade do random.org. Este servidor demonstra o Model Context Protocol fornecendo uma ferramenta para gerar resultados aleatórios com lados configuráveis.

Recursos

Ferramentas

• flip_coin - Lança uma moeda com número configurável de lados
  • Parâmetro opcional sides (padrão: 2)
  • Usa aleatoriedade verdadeira do random.org
  • Tratamento especial para casos extremos (0, 1 ou lados negativos)
  • Para 2 lados: Retorna "Heads" ou "Tails"
  • Para 3 lados: Retorna "Heads", "Tails" ou "_"
  • Para n>3 lados: Retorna "It landed on side X"

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com reconstrução automática:

npm run watch

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "coin-flip": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-coin-flip"]
    }
  }
}

Exemplo de Uso

Depois de conectado a um cliente MCP como o Claude Desktop, você pode usar linguagem natural para interagir com a ferramenta de lançamento de moeda. Por exemplo:

• "Lance uma moeda"
• "Role um dado de 6 lados"
• "Me dê um número aleatório entre 1 e 20"

O servidor usará aleatoriedade verdadeira do random.org para gerar o resultado.

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

MIT