Coin Flip MCP Server

Coin Flip MCP Server

Un servidor MCP que proporciona lanzamientos de moneda verdaderamente aleatorios usando la API de aleatoriedad de random.org. Este servidor demuestra el Protocolo de Contexto de Modelo (MCP) al ofrecer una herramienta para generar resultados aleatorios con lados configurables.

Características

Herramientas

• flip_coin - Lanza una moneda con número configurable de lados
  • Parámetro opcional sides (por defecto: 2)
  • Usa aleatoriedad real de random.org
  • Manejo especial para casos límite (0, 1 o lados negativos)
  • Para 2 lados: Devuelve "Heads" o "Tails"
  • Para 3 lados: Devuelve "Heads", "Tails" o "_"
  • Para n>3 lados: Devuelve "It landed on side X"

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para usar con Claude Desktop, añade la configuración del servidor:

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

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

Ejemplo de Uso

Una vez conectado a un cliente MCP como Claude Desktop, puedes usar lenguaje natural para interactuar con la herramienta de lanzamiento de moneda. Por ejemplo:

• "Lanza una moneda"
• "Lanza un dado de 6 caras"
• "Dame un número aleatorio entre 1 y 20"

El servidor usará aleatoriedad real de random.org para generar el resultado.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

MIT