CARDZ MCP

CARDZ MCP

在 AI 对话中查询评级卡牌价格

免费的只读 MCP 服务，提供已评级集换式卡牌（TCG）数据。可查询 Pokémon 和 One Piece 卡牌的 PSA 10 价格、人口数量、市值和每日历史数据，无需登录。

端点	https://mcp.cardz.game/mcp
传输方式	Streamable HTTP
身份验证	无
价格	免费
网站	https://mcp.cardz.game/
MCP Registry	io.github.cardzgame/cardz-mcp

claude mcp add --transport http cardz https://mcp.cardz.game/mcp

此代码库是托管远程服务的公开目录条目（README、用于 Official MCP Registry 的 server.json）。该远程服务由托管提供；源代码未公开。

CARDZ MCP 是一个托管的只读 MCP 服务，可将 CardZ Marketcap 的 Pokémon 和 One Piece 评级卡牌数据引入任何兼容 MCP 的 AI 对话中。它通过 Streamable HTTP 提供三个工具，无需 API 密钥、账户或登录。

功能介绍

search_cards 按名称或收藏编号查找候选印刷版本，并返回语言、系列和规范卡牌页面链接。get_card 返回单个印刷版本的 PSA 10 参考价格及其日期、PSA 10 人口数量、市值（参考价格 × 人口数量）、百分比变化，以及最多 365 天的每日价格历史记录。get_market 返回 Pokémon、One Piece 或综合跟踪指数的已发布市值排名。

所有价格都是以美元计价的每日参考值，并非实时可执行报价。空值表示数据不可用；服务不会用零替代。

支持的主机中的交互视图

在 ChatGPT 和 Claude 等支持 MCP Apps 的主机中，每个工具都会呈现交互式对话内视图，显示卡牌图片、印刷版本选择器和价格历史控制项。其他主机则会收到相同的结构化数据，以及用户可直接打开的卡牌页面链接。

数据范围与时效性

目前覆盖 CardZ Marketcap 跟踪的已评级 Pokémon 和 One Piece PSA 10 卡牌。每个响应均包含数据日期，该日期可能与查询时间不同。成功响应可能会在 Cloudflare 边缘缓存 60 秒；卡牌图片可能会缓存 24 小时。

隐私

公开查询无需 CARDZ.Game 账户。工具绝不会索取密码、地址、支付详情或钱包信息。搜索词会发送至 CardZ Marketcap 公共 API。服务仅使用源 IP 地址进行速率限制，不会创建玩家个人资料，也不会维护查询历史数据库。

不提供的功能

CARDZ MCP 仅提供数据，不提供交易、购买、开包、拍卖、配送或支付功能。

功能

1. 三个专用工具 — 搜索卡牌、读取单个印刷版本的指标、查看市值排名。
2. 无需身份验证 — 无需 API 密钥、账户或登录；连接后即可立即查询。
3. 交互式对话内视图 — 支持 MCP Apps 的主机（例如 ChatGPT、Claude）会内嵌显示卡牌图片、印刷版本选择和价格历史控制项。
4. 每日 PSA 10 参考价格 — 提供注明日期的美元观察值，每个印刷版本最多包含 365 天的历史数据。
5. 市值排名 — 提供 Pokémon、One Piece 或综合跟踪指数的已发布排名，并标注生效日期。
6. 隐私优先 — 交互视图中不创建玩家个人资料、不维护查询历史数据库、不使用分析工具或浏览器存储。
7. Streamable HTTP 传输 — 单一 URL 端点，兼容任何支持该协议的 MCP 客户端。

工具

工具	描述
search_cards	按名称或收藏编号搜索已评级的 Pokémon 或 One Piece 卡牌；返回候选印刷版本、语言、系列和卡牌页面链接。
get_card	查看单个印刷版本的 PSA 10 参考价格、人口数量、市值、百分比变化、指标日期，以及最多 365 天的每日历史数据。
get_market	按已发布顺序获取 Pokémon、One Piece 或综合指数的已发布市值排名。

设置

通用 MCP JSON 配置

{
  "mcpServers": {
    "cardz": {
      "url": "https://mcp.cardz.game/mcp"
    }
  }
}

Claude Desktop / Claude Code

将上方的 JSON 代码块添加到 Claude MCP 设置中。无需 API 密钥或环境变量。

ChatGPT（自定义 MCP 连接器）

将 Streamable HTTP MCP 连接器指向 https://mcp.cardz.game/mcp — 无需身份验证标头。

Cursor

在 Cursor Settings → MCP 中，添加一个 URL 为 https://mcp.cardz.game/mcp、传输类型为 Streamable HTTP 的新服务。

VS Code（Copilot Chat MCP）

添加到 .vscode/mcp.json 或用户设置中：

{
  "servers": {
    "cardz": {
      "url": "https://mcp.cardz.game/mcp"
    }
  }
}

示例提示词

1. “Charizard ex SAR 217/187 的 PSA 10 价格是多少？”
2. “列出市值最高的 10 张 Pokémon 卡牌。”
3. “比较 Luffy OP05-119 和 Enel OP05-118 的 90 天价格历史。”
4. “搜索 Pikachu 卡牌，并列出所有已追踪的印刷版本。”
5. “目前市值最高的 One Piece 卡牌有哪些？”

常见问题

问：我需要 API 密钥或账号吗？
答：不需要。CARDZ MCP 无需身份验证、API 密钥或 CARDZ.Game 账号。连接到该 URL 即可开始查询。

问：它是免费的吗？
答：是的。该服务可免费使用。请求有速率限制；收到 HTTP 429 响应后请重试。

问：涵盖哪些卡牌？
答：目前涵盖 CardZ Marketcap 追踪的评级版 Pokémon 和 One Piece PSA 10 卡牌。

问：数据有多新？
答：价格是每日参考数据（单位为 USD），并非实时报价。每条响应都包含数据的生效日期。成功的 API 响应可能会在 Cloudflare 边缘缓存 60 秒。

问：会收集我的哪些数据？
答：这些工具不会请求密码、付款详情或钱包信息。源 IP 地址仅用于速率限制。我们不会维护玩家资料或查询历史数据库，交互视图也不包含分析功能或浏览器存储。

关于

CARDZ — CardZ Marketcap 和 Cardz.Game 是 CARDZ 品牌旗下的相关网站。

• CardZ Marketcap：https://cardzmarketcap.com
• Cardz.Game：https://cardz.game

联系方式

[email protected]

许可证

MIT — 适用于此代码仓库的内容。