Scryfall MCP Server

Сервер, реализующий протокол Model Context Protocol (MCP) для взаимодействия с API Scryfall. Предоставляет инструменты для поиска карт Magic: The Gathering, получения официальных разъяснений (rulings) и информации о ценах.

Возможности

• search_cards — текстовый поиск по базе Scryfall. Возвращает список подходящих карт.
• get_card_by_id — получение карты по её UUID в Scryfall.
• get_card_by_name — получение карты по точному английскому названию.
• random_card — случайная карта из всей базы Scryfall.
• get_rulings — официальные разъяснения по карте (уточняют взаимодействия и правила).
• get_prices_by_id — текущие цены (USD, USD foil, EUR, TIX) по Scryfall ID.
• get_prices_by_name — текущие цены по точному названию карты.

Установка и запуск

Сервер можно запустить в двух режимах:

• Stdio (по умолчанию) — общение через стандартный ввод/вывод.
• SSE (Server-Sent Events) — HTTP-эндпоинты.

Через npx

# Stdio режим
npx scryfall-mcp-server

# SSE режим
npx scryfall-mcp-server --sse

Через Docker

Сборка образа:

docker build -t mcp/scryfall .

Запуск:

# Stdio режим
docker run -i --rm mcp/scryfall

# SSE режим
docker run -i --rm -p 3000:3000 mcp/scryfall --sse

Подключение к серверу

Stdio режим

Приложение (например, Claude Desktop) может напрямую общаться с сервером через stdio.

SSE режим

При запуске с флагом --sse сервер доступен по адресам:

• SSE endpoint: http://localhost:3000/sse
• Message endpoint: http://localhost:3000/messages

Подключение через MCP CLI:

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

Интеграция в claude_desktop_config.json

Пример для Stdio через Docker:

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

Или через npx:

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

Лицензия

MIT.