CardsNearby MCP Server已验证已精选

什么是 CardsNearby MCP Server？

CardsNearby MCP Server 把 Claude、Cursor 等 MCP 代理连接到 CardsNearby 的美国卡牌店与卡牌展实时目录，你可以查询美国任意地点附近的球星卡、Pokémon、Magic 或其他 TCG 店铺和活动。

它由 CardsNearby 官方托管，端点为 https://www.cardsnearby.com/api/mcp。它使用 Streamable HTTP（JSON-RPC 2.0），无需认证、只读且免费。除非客户端需要 stdio 桥接，否则无需安装任何东西。

如何使用 CardsNearby MCP Server？

无需账户或 API key，只要把客户端指向该端点即可。

Claude Code

claude mcp add --transport http cardsnearby https://www.cardsnearby.com/api/mcp

Claude Desktop / claude.ai

添加一个自定义连接器（custom connector），URL 填 https://www.cardsnearby.com/api/mcp。由于服务器无需登录，添加后即可直接连接。

如果你更喜欢使用配置文件，CardsNearby 的 README 展示了如何用 mcp-remote 把远程服务器桥接为 stdio（npx 需要 Node.js）：

{
  "mcpServers": {
    "cardsnearby": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.cardsnearby.com/api/mcp"]
    }
  }
}

Cursor

按照 README，将以下内容加入 mcp.json：

{
  "mcpServers": {
    "cardsnearby": {
      "url": "https://www.cardsnearby.com/api/mcp"
    }
  }
}

VS Code

在 .vscode/mcp.json 中添加 url 条目：

{
  "servers": {
    "cardsnearby": {
      "type": "http",
      "url": "https://www.cardsnearby.com/api/mcp"
    }
  }
}

CardsNearby MCP Server 的主要功能

• 覆盖全美的本地卡牌店和卡牌展：球星卡、Pokémon、Magic: The Gathering、Yu-Gi-Oh! 及其他 TCG。
• 可按 latitude + longitude 或美国 city + state 搜索。
• 店铺结果按距离排序，包含地址、经营的游戏、服务、评分、电话以及完整页面链接。
• 卡牌展结果包含场地、下一次举办日期、主要游戏和链接。
• 托管、免费、只读，无需认证。
• CardsNearby 表示数据持续更新。

CardsNearby MCP Server 工具

服务器提供三个工具（已通过实际的 tools/list 调用确认）：

• find_card_shops：查找某地点附近的本地卡牌店。半径默认 25 英里（最大 100），结果数默认 10（最大 25）。
• find_card_shows：查找某地点附近即将举办的卡牌展和展会。半径默认 50 英里（最大 150），结果数默认 10（最大 25）。
• list_coverage：列出 CardsNearby 覆盖的美国州、各州收录的店铺数量及总数。可在按城市搜索前先确认覆盖情况。

两个搜索工具都接受 latitude、longitude、city、state、radius_miles 和 limit 参数。

CardsNearby MCP Server 的使用场景

• 出售收藏：“Find card shops near Charlotte, NC that buy collections.”
• 安排周末：“Are there any card shows within 50 miles of Dallas this month?”
• 查看覆盖范围：“Which states does CardsNearby cover, and where are the most shops?”
• 出行：让助手查找所到城市附近的 Pokémon 或 Magic 店铺，并附上电话以便提前联系。
• 行程规划代理：在同一对话中把卡牌展的日期和场地与日历或路线规划结合起来。

CardsNearby MCP Server 常见问题排查

• Claude Desktop 配置无法启动： mcp-remote 桥接通过 npx 运行，因此需要安装 Node.js 并加入 PATH。
• 小镇搜不到结果： 扩大 radius_miles（店铺最大 100，展会最大 150），或运行 list_coverage 确认该州是否被覆盖。
• 匹配到错误的城市： 在 city 之外同时传入 state，或改用 latitude 和 longitude。
• 结果比预期少： limit 默认是 10，最多可以要求 25 条。