Scryfall MCP 服务器

一个用于与 Scryfall API 交互的 Model Context Protocol (MCP) 服务器。它提供了查询万智牌：集换式卡牌游戏（Magic: The Gathering）卡片详情、裁决和价格信息的工具。

功能

• search_cards
  在 Scryfall 上执行基于文本的搜索。返回匹配的卡片列表。
• get_card_by_id
  通过其 Scryfall UUID 直接检索卡片。
• get_card_by_name
  通过精确的英文名称检索卡片。
• random_card
  从整个 Scryfall 数据库中获取一张随机卡片。
• get_rulings
  检索卡片的官方裁决，这可能澄清了卡片互动或规则。
• get_prices_by_id
  通过 Scryfall ID 获取给定卡片的当前价格信息（USD, USD foil, EUR, TIX）。
• get_prices_by_name
  通过精确名称获取给定卡片的当前价格信息（USD, USD foil, EUR, TIX）。

使用方法

该服务器可以在两种模式下运行：

1. 标准 stdio 模式（默认）
2. 带有 HTTP 端点的 Server-Sent Events (SSE) 模式

使用 NPX

如果您本地安装了 Node.js：

# Stdio mode
npx scryfall-mcp-server

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

连接到服务器

Stdio 模式

您的应用程序或环境（如 Claude Desktop）可以直接通过 stdio 与服务器通信。

SSE 模式

当以 SSE 模式运行（使用 --sse）时，您可以使用 MCP CLI 进行连接：

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

服务器将可在以下位置访问：

• SSE 端点: http://localhost:3000/sse
• 消息端点: http://localhost:3000/messages

在 claude_desktop_config.json 中集成

示例片段（stdio 模式）：

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

或者使用 npx：

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

从 Docker 构建

docker build -t mcp/scryfall .

然后你可以以 stdio 模式运行：

docker run -i --rm mcp/scryfall

或者以 SSE 模式运行：

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

许可证

根据 MIT 许可证授权。