Scryfall

Servidor MCP Scryfall

Um servidor Model Context Protocol (MCP) para interagir com a API do Scryfall. Ele fornece ferramentas para consultar detalhes de cartas de Magic: The Gathering, regras oficiais e informações de preços.

Recursos

• search_cards
  Realiza uma busca baseada em texto no Scryfall. Retorna uma lista de cartas correspondentes.
• get_card_by_id
  Recupera uma carta diretamente pelo seu UUID do Scryfall.
• get_card_by_name
  Recupera uma carta pelo nome exato em inglês.
• random_card
  Obtém uma carta aleatória de todo o banco de dados do Scryfall.
• get_rulings
  Recupera as regras oficiais de uma carta, que podem esclarecer interações ou regras da carta.
• get_prices_by_id
  Recupera informações de preços atuais (USD, USD foil, EUR, TIX) para uma carta específica pelo ID do Scryfall.
• get_prices_by_name
  Recupera informações de preços atuais (USD, USD foil, EUR, TIX) para uma carta específica pelo nome exato.

Uso

O servidor pode ser executado em dois modos:

1. Modo stdio padrão (padrão)
2. Modo Server-Sent Events (SSE) com endpoints HTTP

Usando NPX

Se você tiver o Node.js instalado localmente:

# Stdio mode
npx scryfall-mcp-server

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

Conectando ao Servidor

Modo Stdio

Seu aplicativo ou ambiente (como o Claude Desktop) pode se comunicar diretamente via stdio com o servidor.

Modo SSE

Ao executar no modo SSE (com --sse), você pode se conectar usando o CLI do MCP:

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

O servidor estará disponível em:

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

Integração no claude_desktop_config.json

Exemplo de trecho para o modo stdio:

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

Ou com npx:

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

Construindo a partir do Docker

docker build -t mcp/scryfall .

Em seguida, você pode executar no modo stdio:

docker run -i --rm mcp/scryfall

Ou no modo SSE:

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

Licença

Licenciado sob a Licença MIT.