Scryfall MCP Server

一个用于与Scryfall API交互的Model Context Protocol (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端点的Server-Sent Events (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许可证授权。