游戏制作MCP服务器
](https://www.npmjs.com/package/@alex-gon/tgc-mcp-server)    
将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