AI导哈

桌面游戏设计服务器

一个连接AI助手与The Game Crafter API的MCP服务器，用于通过自然对话设计、管理和定价桌面游戏。

  • by alex-gon
  • TypeScript
  • 混合部署
  • 3 星标
  • 更新于
在 GitHub 查看 alex-gon/thegamecrafter-mcp-server

使用说明

游戏制作MCP服务器

将AI助手连接到的MCP服务器 游戏制作者 API，让您通过自然对话设计、管理和定价桌面游戏。

浏览组件目录，创建游戏项目，添加纸牌和棋盘，上传艺术品，并通过您的AI助手获得即时定价估算。

给谁的

独立棋盘游戏设计师、桌面创作者和TGC用户，他们希望通过人工智能助手管理他们的项目，而不是手动导航TGC web界面。

先决条件

安装

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

连接到托管服务器：

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

不需要本地设置。致电时提供您的TGC凭据 authenticate 工具。使用量通过Apify的按事件付费模式按每次操作计费（每个典型会话约0.09美元）。

也可在 Glama连接器.

选项2：本地（通过npx）

将服务器添加到Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "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"
      }
    }
  }
}

重新启动克劳德桌面。服务器将自动下载并显示在您的MCP连接中。

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

然后使用 "command": "node" 和 "args": ["/absolute/path/to/dist/index.js"] 在上面的配置中。

配置

变量 必填 描述
TGC_API_KEY_ID 是 您的TGC API密钥ID
TGC_USERNAME 是 您的TGC帐户用户名
TGC_PASSWORD 是 您的TGC帐户密码
TGC_API_BASE 没有 API基本URL（默认为 https://www.thegamecrafter.com/api)
TGC_UPLOAD_BASE_DIR 否 限制文件上传到此目录（默认为工作目录）

看 .env.example 对于模板。

可用工具

工具

工具 描述 身份验证
authenticate 创建TGC会话（接受凭据作为参数或使用环境变量） 否
logout 销毁当前TGC会话 是
get_game_catalog 浏览可打印的组件类型（卡、板、盒） 否
get_component_sizes 获取组件类型的像素尺寸和成品英寸 否
get_component_details 获取组件类型或游戏部件的详细信息 否
get_my_designers 列出已验证用户的设计器配置文件 是
get_my_games 列出设计师的所有游戏（分页） 是
get_game_details 获取包含组件、文件和定价的完整游戏信息 是
create_game 在设计师的指导下创建新游戏项目 是
update_game 更新游戏的名称、描述或可见性 是
delete_game 永久删除游戏项目 是
add_component_to_game 将可打印的组件或库存零件添加到游戏中 是
upload_file 将图像上传到TGC文件夹（从磁盘或URL） 是
get_pricing_estimate 获取游戏的每个组件成本明细 是

资源

URI 描述
tgc://catalog 可打印组件类型的完整目录（缓存30分钟）
tgc://game/{id}/summary 游戏项目的完整摘要
tgc://component-sizes 所有组件类型的像素尺寸（缓存30分钟）

提示

提示 描述
new_game_setup 使用组件创建完整游戏项目的指导工作流程
estimate_game_cost 现有游戏的逐步成本估算

示例提示

试着对你的AI助手说：

  • “在The Game Crafter上显示我的所有游戏及其组件列表”
  • “使用标准扑克牌和暗箱创建一款名为Stellar Drift的新纸牌游戏”
  • “我需要什么像素尺寸来制作扑克牌脸图像？”
  • “上传此图像并将其指定为我的卡片组的正面”
  • “根据当前组件估算我的游戏成本”
  • “帮助我从头开始建立一个新的游戏项目——引导我完成它”
  • “棋盘游戏有哪些组件类型？”
  • “删除我的测试游戏项目”

局限性

  • 费率限制 --服务器每秒向TGC强制执行3个请求（低于其每秒4个的限制），每个会话的预算为500次读取和200次写入。
  • 认证 --凭据可以传递为 authenticate 工具参数（远程使用所需）或通过环境变量（本地stdio）。OAuth 2.1支持计划在未来的版本中发布。
  • 文件上传 --每个文件最大50 MB。图像必须在50x50和10000x10000像素之间。支持的格式：PNG、JPG、GIF、BMP、TIFF、SVG、WebP、PDF。
  • 运输 --当地使用标准。远程HTTP可通过 托管Apify端点.
  • 只读目录 --组件目录和定价来自TGC，不能修改。

贡献

欢迎Bug报告和pull请求。请先打开一个问题，讨论您想更改的内容。

要运行开发服务器，请执行以下操作：

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

许可证

麻省理工学院

相关 MCP