iwantmymtg-mcp

iwantmymtg-mcp

一个面向 I Want My MTG 的 MCP 服务。它将 IWMM 的 API 暴露为工具，让 Claude Desktop、Claude Code、Cursor 和其他 MCP 客户端能够通过对话搜索 Magic: The Gathering 卡牌／系列并管理用户收藏。

已发布至 npm、MCP Registry 和 Smithery。工具覆盖范围会随着 API 扩展；完整且持续更新的工具列表请参见 docs/TOOLS.md。

你可以做什么

• 匿名使用（无需密钥）： 搜索卡牌、按系列代码和编号查询卡牌、获取当前价格和近 30 天价格历史、获取卡牌的收购报价（供应商回收价格）、列出系列及其卡牌、列出未拆封产品。
• 已验证身份（使用 IWMM API 密钥）： 管理库存和交易；构建和管理套牌（创建套牌、从套牌列表导入、编辑卡牌、将缺少的卡牌添加到待购清单）；查看投资组合摘要、历史记录、表现、现金流、已实现收益和分类明细（包括按颜色分类，并可进一步查看各项明细）；管理价格提醒和通知。
• 出售工具（需要密钥）： 查看收藏的市场出售价值（按供应商分组，取每张卡牌的最高收购报价）、管理待购清单（想要清单），并获取以现金或商店积分出售以满足待购清单需求的建议。

请参见项目路线图，了解后续计划。

安装

需要 Node 20+。

npx iwantmymtg-mcp

或者按需进行全局安装：

npm install -g iwantmymtg-mcp
iwantmymtg-mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": {
        "IWMM_API_KEY": "iwm_live_..."
      }
    }
  }
}

IWMM_API_KEY 为可选项；只读工具无需密钥即可使用。请在 https://iwantmymtg.net/user/api-keys 创建密钥。

Claude Code

将以下内容添加到项目中的 .mcp.json（或全局配置文件 ~/.claude/.mcp.json）：

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": { "IWMM_API_KEY": "iwm_live_..." }
    }
  }
}

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局配置）或项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "iwmm": {
      "command": "npx",
      "args": ["-y", "iwantmymtg-mcp"],
      "env": { "IWMM_API_KEY": "iwm_live_..." }
    }
  }
}

保存后，重启 Cursor，并确认 iwmm 出现在 Settings -> Features -> MCP Servers 中。

示例提示词

• “搜索 Lightning Bolt 的各个印刷版本，并告诉我最便宜的是哪一个。”
• “Modern Horizons 3 中 Bloodbraid Elf 的价格历史如何？”
• “将 4 张 Lightning Bolt LEA 添加到我的库存。”
• “MH3 有哪些未拆封产品？”
• “我现在出售收藏能卖多少钱？哪家供应商出价最高？”
• “把这些卡牌添加到我的待购清单，然后告诉我现金和商店积分哪种交易更划算。”

常见工作流程的操作指南请参见 examples/，完整的工具参考请参见 docs/TOOLS.md。

配置

环境变量	默认值	用途
IWMM_API_KEY	(未设置)	个人 API 密钥。仅已验证身份的工具需要。
IWMM_BASE_URL	https://iwantmymtg.net	用于可自托管或本地开发版 IWMM 实例的覆盖 URL。

本地开发

npm install
npm run build
node dist/index.js

也可使用 tsx 实现实时重载：

npm install
npx tsx src/index.ts

许可证

本项目采用 MIT 许可证授权；详情请参见 LICENSE 文件。