iDos Games SDK

iDos Games MCP

面向 iDos Games 的官方 Model Context Protocol 服务。这是一个面向跨平台游戏（Web、Android、iOS、PC）的后端与发布平台，支持 web3。将它们连接到 Claude、 ChatGPT、Cursor、VS Code、Codex 或任何其他 MCP 客户端，即可让你的 AI 助手构建、配置并发布 游戏。

这里有两个服务，各自承担不同的工作：

	iDos Games (com.idosgames/platform)	iDos Games SDK (com.idosgames/sdk)
处理内容	你的线上游戏：游戏的数据；以及游戏模块和 SDK 技能	项目中的游戏代码：模块和技能，离线运行
运行位置	托管服务：https://site.idosgames.com/api/v2/mcp	本地：npx -y @idosgames/mcp
传输方式	Streamable HTTP	stdio
登录方式	OAuth 2.1，可自行选择游戏和权限（模块和技能无需登录即可使用）	无（公开，只读）
适用于纯浏览器客户端（claude.ai、ChatGPT）	是	否，需要能够启动本地进程的客户端

两者提供相同的游戏模块目录、项目脚手架和 SDK 技能，因此纯浏览器客户端（claude.ai、ChatGPT）可从托管服务获取这些内容。游戏的实时配置、生成的资源、任务板和构建内容只能通过 iDos Games 服务访问；SDK 服务无需登录，且可离线使用。

iDos Games（托管版）

你的助手可以用它做什么：

• 查找你的游戏，并查看它在每款游戏中获准执行的操作（list_my_titles）。
• 创建新游戏（create_title，拥有独立权限）：与控制面板的操作方式相同，它会占用你套餐中的一个名额，并获得基础系统、一个游戏模块、一个可直接使用的初始构建版本和一份沙盒（DEV）副本。新游戏会立即加入助手可访问的游戏列表，因此助手接下来就能配置并发布它。
• 逐个部分读取和更新游戏配置：虚拟货币、物品、商店、战利品箱、任务、限时活动和合作活动、赛季、排行榜、制作、奖励、高级功能、教程、A/B 实验、本地化、聊天、多人游戏、推送、广告等（get_<section> / save_<section>）。每个部分单独保存，因此配置的其余部分不会受到影响。
• Web3：在 EVM 网络和 Solana 上使用链上代币作为游戏货币、使用 NFT 作为物品；通过奖励池存取玩家资金；支持代币门控游戏和钱包登录；以及网络、合约地址和 Gas 策略（get_blockchain / save_blockchain，在 save_currency 中设置加密货币，在 save_item 中设置 NFT 物品）。代币发行和持有者质押可直接在 idosgames.com 上进行。
• 游戏数据和本地化键：游戏共享的键值数据及其文本键。
• 服务器逻辑：发布 CloudCode，并列出密钥名称（绝不会返回密钥值）。
• 使用 AI 生成素材：图片、语音和音效、音乐、短视频、3D 模型和文本。生成会消耗你账户中的点数，因此助手可以先调用 list_ai_tiers 和 estimate_media_cost 进行检查，再开始生成。
• 任务看板：项目、列、卡片、负责人和评论。
• 发布构建版本：上传可直接使用的 Web 构建版本，获取测试链接，然后将其上线供玩家使用。
• 游戏模块和 SDK 技能（只读，无需游戏）：项目脚手架（get_host_scaffold）、可直接使用的游戏和系统，例如商店、任务、物品栏、排行榜和多人游戏（list_modules、search_modules、get_module）、准确的 SDK 软件包版本（get_manifest）以及 SDK 使用指南（list_skills、get_skill）。
• 视频工作室目录（只读，无需游戏）：短视频格式及视频可以包含的所有内容（list_video_formats、get_video_format）、可直接使用的角色、场景和音乐库（search_assets）以及完整的视频示例（list_video_templates）。
• 为视频工作室创作视频（消耗点数）：plan_video 通过工作室的 AI 导演将创意转化为可直接使用的视频；generate_asset 为视频生成角色、场景、道具或音乐，并将其放置在相应位置。返回内容是视频包（{ spec, assets }）以及一个可在应用编辑器中打开的链接；MP4 会在玩家的设备上生成。publish_asset 会将素材作为官方内容发布到应用的 Workshop 中。

每个工具都有 title 和 readOnlyHint / destructiveHint / openWorldHint 注解；create_title 还会标注 idempotentHint: false（每次成功调用都会创建另一款游戏）。

登录方式

将该服务添加为普通 HTTP MCP 服务，不需要请求头，也不需要 API 密钥。调用 initialize 和 tools/list 无需登录。首次调用工具时会返回 401，客户端会打开 iDos Games 登录页面；你可以选择助手可使用哪些游戏、在每款游戏中可以执行哪些操作（读取配置、写入配置、生成素材、上传构建版本……），以及是否允许创建新游戏。之后客户端会重新调用该工具。你可以随时在 Connected apps 中撤销访问权限。

连接

Claude（claude.ai、Desktop、mobile）：Settings → Connectors → Add custom connector → https://site.idosgames.com/api/v2/mcp。

Claude Code

claude mcp add --transport http idosgames https://site.idosgames.com/api/v2/mcp

ChatGPT：Settings → Apps & Connectors → Advanced → Developer mode → Create，URL 为 https://site.idosgames.com/api/v2/mcp，身份验证方式为 OAuth。

Codex CLI

codex mcp add idosgames --url https://site.idosgames.com/api/v2/mcp

Gemini CLI

gemini mcp add --transport http idosgames https://site.idosgames.com/api/v2/mcp

Cursor（.cursor/mcp.json）、Windsurf（~/.codeium/windsurf/mcp_config.json，键 serverUrl）、 VS Code（.vscode/mcp.json）：请参阅在一个配置中使用两个服务。

iDos Games SDK（本地）

向编码 Agent 提供 iDos Games 模块与技能注册表：

工具	用途
list_modules	可组合游戏模块目录（游戏和系统：商店、任务、库存、排行榜……）
get_module	单个模块的完整源代码和安装说明
get_host_scaffold	每个新项目的基础框架（登录、大厅、配置）
get_manifest	运行时 @idosgames/* 包及其准确版本
list_skills / get_skill	如何针对 @idosgames/core、模块约定和组合方式进行编码
search	按所需功能查找现成模块
validate_asset / validate_video	使用视频工作室自身的代码检查视频工作室资源或视频包；提供 title_id 时会返回可在应用中打开该视频的链接

所有工具均为只读，并返回内容。Agent 会将文件写入自己的项目。注册表已打包在该包中，因此也可离线使用。

claude mcp add idosgames-sdk -- npx -y @idosgames/mcp

npm： @idosgames/mcp 。

在一个配置中使用两个服务

Cursor，.cursor/mcp.json：

{
  "mcpServers": {
    "idosgames": { "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

VS Code，.vscode/mcp.json：

{
  "servers": {
    "idosgames": { "type": "http", "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "type": "stdio", "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Windsurf，~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "idosgames": { "serverUrl": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Claude Code，.mcp.json：

{
  "mcpServers": {
    "idosgames": { "type": "http", "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

提示词示例

• “创建一款名为 Moon Farm 的全新放置类 RPG，并为其添加三种货币。”
• “显示为我的游戏配置的虚拟货币和商店物品。”
• “添加一个每日任务：赢得 3 场比赛即可获得 100 金币。”
• “生成一张 512×512 的火焰之剑图标，并将其添加到物品目录。”
• “启动一个带有商店和每日任务的放置类 RPG 新项目。”（SDK 服务）
• “构建游戏并将其上传为测试版本。”（两个服务）
• “我的看板上分配了哪些任务？”

链接

• 文档：idosgames.com/mcp
• 支持：idosgames.com/mcp#support，[email protected]
• 隐私政策：idosgames.com/privacy
• 条款：idosgames.com/terms

许可证

SDK 服务（@idosgames/mcp）采用 MIT 许可证；详见 LICENSE。托管的 iDos Games 服务受 iDos Games 条款约束。