Scryfall

Servidor MCP de Scryfall

Un servidor de Model Context Protocol (MCP) para interactuar con la API de Scryfall. Proporciona herramientas para consultar detalles de cartas de Magic: The Gathering, reglas oficiales e información de precios.

Características

• search_cards
  Realiza una búsqueda basada en texto en Scryfall. Devuelve una lista de cartas coincidentes.
• get_card_by_id
  Recupera una carta directamente mediante su UUID de Scryfall.
• get_card_by_name
  Recupera una carta por su nombre exacto en inglés.
• random_card
  Obtiene una carta aleatoria de toda la base de datos de Scryfall.
• get_rulings
  Recupera las reglas oficiales de una carta, que pueden aclarar interacciones o reglas de la carta.
• get_prices_by_id
  Recupera información de precios actual (USD, USD foil, EUR, TIX) para una carta determinada mediante su ID de Scryfall.
• get_prices_by_name
  Recupera información de precios actual (USD, USD foil, EUR, TIX) para una carta determinada por su nombre exacto.

Uso

El servidor se puede ejecutar en dos modos:

1. Modo stdio estándar (predeterminado)
2. Modo Server-Sent Events (SSE) con endpoints HTTP

Usando NPX

Si tienes Node.js instalado localmente:

# Stdio mode
npx scryfall-mcp-server

# SSE mode
npx scryfall-mcp-server --sse

Conexión al Servidor

Modo Stdio

Tu aplicación o entorno (como Claude Desktop) puede comunicarse directamente mediante stdio con el servidor.

Modo SSE

Cuando se ejecuta en modo SSE (con --sse), puedes conectarte usando la CLI de MCP:

npx @wong2/mcp-cli --sse http://localhost:3000/sse

El servidor estará disponible en:

• Endpoint SSE: http://localhost:3000/sse
• Endpoint de mensajes: http://localhost:3000/messages

Integración en claude_desktop_config.json

Ejemplo de fragmento para modo stdio:

{
  "mcpServers": {
    "scryfall": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/scryfall"]
    }
  }
}

O con npx:

{
  "mcpServers": {
    "scryfall": {
      "command": "npx",
      "args": ["scryfall-mcp-server"]
    }
  }
}

Compilación desde Docker

docker build -t mcp/scryfall .

Luego puedes ejecutarlo en modo stdio:

docker run -i --rm mcp/scryfall

O en modo SSE:

docker run -i --rm -p 3000:3000 mcp/scryfall --sse

Licencia

Licenciado bajo la Licencia MIT.