卡牌查询服务

一个基于Scryfall API的MCP服务器,提供《魔法风云会》卡牌详情、规则解释和价格信息的查询功能。

  • by cryppadotta
  • JavaScript
  • 混合部署
  • 36 星标
  • 更新于
在 GitHub 查看 cryppadotta/scryfall-mcp

使用说明

Scryfall MCP服务器

A. 模型上下文协议(MCP) 用于与交互的服务器 Scryfall API它提供了查找魔法:收集卡详细信息、卡规则和价格信息的工具。

特性

  • 搜索卡
    在Scryfall上执行基于文本的搜索。返回匹配的卡片列表。
  • get_card_by_id
    直接通过其Scryfall UUID检索卡。
  • get_card_by_name
    按准确的英文名字取回卡片。
  • 随机卡
    从整个Scryfall数据库中随机获取一张卡片。
  • 获取链接
    检索卡的官方裁决,这可能会澄清卡的互动或规则。
  • get_prices _ by_id
    通过Scryfall ID检索给定卡的当前定价信息(美元、美元箔、欧元、TIX)。
  • get_prices_by_name
    按确切名称检索给定卡的当前定价信息(美元、美元箔、欧元、TIX)。

用法

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

  1. 标准标准输入输出模式(默认)
  2. 具有HTTP端点的服务器发送事件(SSE)模式

使用NPX

如果你在本地安装了Node.js:

# Stdio mode
npx scryfall-mcp-server

# SSE mode
npx scryfall-mcp-server --sse

连接到服务器

标准模式

您的应用程序或环境(如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许可证获得许可。