Scryfall MCP App

Scryfall MCP服务器

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

Card viewer UI in Claude Desktop

工具

• 搜索 --使用以下方式搜索卡片 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主机接收包含所有卡详细信息的文本回退