Scryfall MCP 服务器

一个用于与 Scryfall API交互的 Model Context Protocol (MCP) 服务器。它提供了查找 Magic: The Gathering 卡牌详细信息、卡牌规则和价格信息的工具。

功能

• 搜索卡片
  根据文本在 Scryfall 上执行搜索。返回匹配卡片的列表。
• 通过 ID 获取卡片
  通过 Scryfall UUID 直接检索卡片。
• 通过名称获取卡片
  通过英文名称精确检索卡片。
• 随机卡片
  从整个 Scryfall 数据库中获取一张随机卡片。
• 获取规则
  检索某张卡牌的官方规则，这些规则可能解释了卡牌互动或规则。
• 通过 ID 获取价格信息
  根据 Scryfall ID 检索当前价格信息（USD、USD 金箔、EUR、TIX）。
• 通过名称获取价格信息
  通过英文名称精确检索卡片的当前价格信息（USD、USD 金箔、EUR、TIX）。

使用方法

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

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

许可证

本项目 licensed under the MIT License。