魔法风云会卡牌搜索服务

一个社区MCP服务器,用于从Scryfall搜索和获取魔法风云会卡牌数据,提供卡牌图像、法力符号、预言文本和价格展示功能。

  • by olaservo
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 olaservo/scryfall-mcp-app

使用说明

Scryfall MCP服务器

用于搜索和获取Magic的社区MCP服务器:从收集卡数据 Scryfall.特点和 MCP应用程序 在兼容主机(如Claude Desktop)中使用时,呈现卡片图像、法力符号、甲骨文和定价的UI。

注: 这是一个独立的社区项目。它与Scryfall没有关联,也没有得到Scryfall的认可。

工具

  • 搜索 --使用以下方式搜索卡片 Scryfall全文语法 (例如。, c:red t:creature cmc=3, set:mkm, o:"draw a card")
  • 获取 --通过Scryfall UUID获取完整的卡详细信息。在支持MCP App的主机中,呈现一个卡片查看器UI,其中包含卡片图像、法力成本图标、甲骨文、集合信息、稀有性和价格。

安装

选项1:MCPB(克劳德桌面一键安装)

下载 scryfall-mcp-server.mcpb 从最新版本开始,在Claude Desktop中打开它。

选项2:npm

{
  "mcpServers": {
    "scryfall": {
      "command": "npx",
      "args": ["-y", "@olaservo/scryfall-mcp-server"]
    }
  }
}

选项3:从源代码构建

git clone https://github.com/olaservo/scryfall-mcp-app.git
cd scryfall-mcp-app
npm install
npm run build

然后添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "scryfall": {
      "command": "node",
      "args": ["/path/to/scryfall-mcp-app/dist/index.js"]
    }
  }
}

发展

npm run dev          # Watch mode with tsx
npm run build        # Build UI + server
npm run inspector    # Test with MCP Inspector
npm run pack         # Build .mcpb bundle

运作原理

服务器使用 MCP应用程序扩展 配对 fetch 带有卡片查看器UI资源的工具。取卡时:

  • content 返回模型的可读文本摘要(卡片文本、元数据、价格)
  • structuredContent 将完整的卡数据发送到UI进行渲染
  • 用户界面呈现卡片图像、魔法消耗和神谕文本中的Scryfall魔法符号SVG以及卡片元数据
  • CSP配置为允许来自以下位置的图像 cards.scryfall.io 以及SVG svgs.scryfall.io
  • 非UI主机接收包含所有卡详细信息的文本回退