Scryfall MCP 服务器

一个用于与 Scryfall API 交互的 模型上下文协议 (MCP) 服务器。 它提供了查找万智牌卡牌详情、卡牌规则和价格信息的工具。

功能

• search_cards
  在 Scryfall 上执行基于文本的搜索。 返回匹配卡牌的列表。
• get_card_by_id
  通过其 Scryfall UUID 直接检索卡牌。
• get_card_by_name
  通过确切的英文名称检索卡牌。
• random_card
  从整个 Scryfall 数据库中获取一张随机卡牌。
• get_rulings
  检索卡牌的官方规则，这些规则可以澄清卡牌互动或规则。
• get_prices_by_id
  通过 Scryfall ID 检索给定卡牌的当前定价信息（美元、美元闪卡、欧元、TIX）。
• get_prices_by_name
  通过确切名称检索给定卡牌的当前定价信息（美元、美元闪卡、欧元、TIX）。

用法

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

1. 标准 stdio 模式（默认）
2. 带有 HTTP 端点的服务器发送事件 (SSE) 模式

使用 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

许可证

在 MIT 许可证下获得许可。