Scryfall

🚀 Scryfall MCP 服務器

Scryfall MCP 服務器是一個基於 Model Context Protocol (MCP) 的工具，用於與 Scryfall API 進行交互。它能幫助用戶快速查找 Magic: The Gathering 卡牌的詳細信息、規則以及價格信息。

🚀 快速開始

該服務器可以以兩種模式運行：

1. 標準 stdio 模式（默認）
2. Server-Sent Events (SSE) 模式，帶 HTTP 終點

使用 NPX

如果您已經在本地安裝了 Node.js，可按以下命令運行：

# Stdio 模式
npx scryfall-mcp-server

# SSE 模式
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

✨ 主要特性

• 搜索卡片：根據文本在 Scryfall 上執行搜索，返回匹配卡片的列表。
• 通過 ID 獲取卡片：通過 Scryfall UUID 直接檢索卡片。
• 通過名稱獲取卡片：通過英文名稱精確檢索卡片。
• 隨機卡片：從整個 Scryfall 數據庫中獲取一張隨機卡片。
• 獲取規則：檢索某張卡牌的官方規則，這些規則可能解釋了卡牌互動或規則。
• 通過 ID 獲取價格信息：根據 Scryfall ID 檢索當前價格信息（USD、USD 金箔、EUR、TIX）。
• 通過名稱獲取價格信息：通過英文名稱精確檢索卡片的當前價格信息（USD、USD 金箔、EUR、TIX）。

📄 許可證

本項目根據 MIT 許可證授權。