Scryfall MCP Server

Scryfall MCP Server

site icon
2025.02.13 2
JavaScript卡牌游戏服务娱乐功能
Scryfall MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Scryfall API 交互,提供查找《魔法风云会》(Magic: The Gathering)卡牌详细信息、卡牌规则和价格信息的功能。
View on GitHub

Overview

基本能力

产品定位

Scryfall MCP Server 是一个专门为《魔法风云会》卡牌游戏设计的服务,提供卡牌搜索、规则查询和价格信息等功能。

核心功能

  • search_cards: 执行基于文本的搜索,返回匹配的卡牌列表。
  • get_card_by_id: 通过 Scryfall UUID 直接检索卡牌。
  • get_card_by_name: 通过英文名称检索卡牌。
  • random_card: 从 Scryfall 数据库中随机获取一张卡牌。
  • get_rulings: 检索卡牌的官方规则,澄清卡牌交互或规则。
  • get_prices_by_id: 通过 Scryfall ID 检索卡牌的当前价格信息(USD, USD foil, EUR, TIX)。
  • get_prices_by_name: 通过卡牌名称检索当前价格信息。

适用场景

  • 卡牌游戏玩家查询卡牌详细信息。
  • 开发者集成卡牌数据到自己的应用中。
  • 卡牌收藏者查询卡牌价格信息。

工具列表

  • npx scryfall-mcp-server: 运行服务的命令行工具。
  • @wong2/mcp-cli: 用于连接 SSE 模式的 MCP CLI 工具。
  • Docker: 用于构建和运行服务的容器化工具。

常见问题解答

  • 如何运行服务?可以通过 npx 或 Docker 运行。
  • 如何连接服务?可以通过 stdio 或 SSE 模式连接。

使用教程

使用依赖

  • Node.js 环境
  • Docker(可选)

安装教程

# 使用 NPX 运行
npx scryfall-mcp-server

# 使用 Docker 构建
docker build -t mcp/scryfall .

# 使用 Docker 运行
docker run -i --rm mcp/scryfall

调试方式

# 检查服务是否运行
npx scryfall-mcp-server --help

# 检查 SSE 模式
npx @wong2/mcp-cli --sse http://localhost:3000/sse

许可证

该项目遵循 MIT 开源许可条款。