The Game Crafter

The Game Crafter MCP 服务

一个 MCP 服务，可将 AI 助手连接到 The Game Crafter API，让你通过自然对话设计、管理和估算桌游价格。

浏览组件目录、创建游戏项目、添加卡牌套组和游戏板、上传美术作品并立即获取价格估算——所有操作都可通过 AI 助手完成。

适用人群

希望通过 AI 助手管理项目，而非手动浏览 TGC 网页界面的独立桌游设计师、桌游创作者和 TGC 用户。

前提条件

• Node.js 18 或更高版本
• 一个 TGC 账户 — 在此注册
• 一个 TGC API 密钥 — 在此生成

安装

选项 1：远程（托管在 Apify 上）——无需安装

连接到托管服务：

https://chillbot3000--tgc-mcp-server.apify.actor/mcp

无需本地设置。调用 authenticate 工具时提供你的 TGC 凭据。费用按 Apify 的按事件计费模式逐次操作收取（典型会话约 $0.09）。

也可通过 Glama Connectors 使用。

选项 2：本地（通过 npx）

将服务添加到 Claude Desktop 配置文件（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "thegamecrafter": {
      "command": "npx",
      "args": ["-y", "@alex-gon/tgc-mcp-server"],
      "env": {
        "TGC_API_KEY_ID": "your-api-key-id",
        "TGC_USERNAME": "your-tgc-username",
        "TGC_PASSWORD": "your-tgc-password"
      }
    }
  }
}

重启 Claude Desktop。服务将自动下载，并出现在 MCP 连接中。

git clone https://github.com/alex-gon/thegamecrafter-mcp-server.git
cd thegamecrafter-mcp-server
npm install && npm run build

配置

请参阅 .env.example 获取模板。

可用工具

工具

资源

提示词

示例提示词

试着对 AI 助手说：

• “显示我在 The Game Crafter 上的所有游戏及其组件列表”
• “创建一款名为 Stellar Drift 的新卡牌游戏，包含一套标准扑克牌和一个 tuck box”
• “扑克牌正面图片需要多大的像素尺寸？”
• “上传这张图片，并将其指定为我的卡牌套牌的正面”
• “根据游戏当前的组件估算成本”
• “帮我从头开始设置新的游戏项目，逐步引导我完成”
• “棋盘游戏有哪些可用的组件类型？”
• “删除我的测试游戏项目”

限制

• 速率限制 — 服务向 TGC 发送请求时强制限制为每秒 3 个请求（低于 TGC 每秒 4 个请求的限制），每个会话的配额为 500 次读取和 200 次写入。
• 身份验证 — 凭据可以作为 authenticate 工具参数传入（远程使用时必须提供），也可以通过环境变量传入（本地 stdio 使用时）。计划在未来版本中支持 OAuth 2.1。
• 文件上传 — 每个文件最大为 50 MB。图片尺寸必须介于 50x50 和 10,000x10,000 像素之间。支持的格式：PNG、JPG、GIF、BMP、TIFF、SVG、WebP、PDF。
• 传输方式 — 本地使用 stdio。远程 HTTP 可通过托管的 Apify 端点使用。
• 只读目录 — 组件目录和定价数据来自 TGC，无法修改。

参与贡献

欢迎提交 Bug 报告和拉取请求。请先创建议题，讨论你希望进行的更改。

运行开发服务器：

cp .env.example .env    # fill in your credentials
npm run dev             # starts with tsx + hot reload
npm test                # run the test suite

许可证

MIT