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 许可证授权。