AGS游戏模型上下文协议服务器

AGS MCP服务器是一个专为Adventure Game Studio (AGS)设计的工具,用于操作编译后的房间文件(.crm)。它作为桥梁,使AI能够直接访问二进制AGS房间数据,实现完整的AI驱动的冒险游戏开发流程。

  • by wilson-lilburne
  • 更新于
在 GitHub 查看 wilson-lilburne/ags-mcp-server

使用说明

基本能力

产品定位

AGS MCP服务器是一个专为Adventure Game Studio (AGS)设计的工具,用于操作编译后的房间文件(.crm)。它作为桥梁,使AI能够直接访问二进制AGS房间数据,实现完整的AI驱动的冒险游戏开发流程。

核心功能

  • 读取房间数据:解析.crm文件并提取结构化信息
  • 块管理:列出、导出和导入房间文件中的特定块
  • 热点工具:以编程方式读取和修改热点交互
  • 脚本集成:自动将热点事件连接到脚本函数
  • 跨平台:支持Windows、macOS和Linux
  • AI集成:兼容Claude Desktop、Cline和其他MCP客户端

适用场景

  • AI驱动的冒险游戏开发
  • 自动连接脚本函数到房间元素
  • 批量处理多个房间文件
  • 游戏测试和验证

使用教程

使用依赖

  • Node.js 18+
  • npm 7+

安装教程

# 使用npx直接运行(推荐)
npx ags-mcp-server

# 本地开发安装
# 克隆仓库
git clone <repository>
cd ags-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

# 运行服务器
npm start

调试方式

# 运行演示
npm run demo

# 验证MCP协议
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | npx ags-mcp-server

# 检查版本
npx ags-mcp-server --version

# 调试模式
DEBUG=ags-mcp:* npx ags-mcp-server