morx-gms2-mcp 0.4.0__tar.gz

morx_gms2_mcp-0.4.0/.github/workflows/release.yml

@@ -0,0 +1,63 @@
+name: release
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  build:
+    if: github.repository == 'MKTLMORX/morx-gms2-mcp'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: python -m pip install build
+      - name: Verify tag matches package version
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          python - <<'PY'
+          import os
+          import pathlib
+          import re
+          source = pathlib.Path('morx_gms2_mcp/__init__.py').read_text(encoding='utf-8')
+          version = re.search(r"__version__\s*=\s*['\"]([^'\"]+)", source).group(1)
+          tag = os.environ['GITHUB_REF_NAME']
+          if tag != 'v' + version:
+              raise SystemExit(f'tag {tag} does not match package version {version}')
+          PY
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+  publish:
+    needs: build
+    if: github.repository == 'MKTLMORX/morx-gms2-mcp'
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+  github-release:
+    needs: publish
+    if: github.repository == 'MKTLMORX/morx-gms2-mcp' && startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "${{ github.ref_name }}" dist/* --generate-notes --verify-tag

morx_gms2_mcp-0.4.0/.github/workflows/tests.yml

@@ -0,0 +1,23 @@
+name: tests
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  windows:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.10', '3.12']
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install . build
+      - run: python scripts/check_public_files.py
+      - run: python -m unittest discover -s tests -t . -v
+      - run: python -m build
+      - run: python scripts/build_release.py

morx_gms2_mcp-0.4.0/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.codex/
+.mcp.json
+.mcp-demo-inputs/
+.env
+.env.*
+!.env.example
+.claude/
+CLAUDE.local.md
+*.pem
+*.key
+*.p12
+*.pfx
+*.log
+*.stackdump
+.mcp-backups/
+.gm_cache/

morx_gms2_mcp-0.4.0/CHANGELOG.md

@@ -0,0 +1,62 @@
+# 更新记录
+
+## 0.4.0 — 2026-10-17
+
+- 运行桥接新增未处理异常捕获；`get_runtime_errors` 按游标返回最多 20 条异常或桥接命令错误，并在 `runtime_status`/`stop_game` 中给出数量。
+- 新增 `trigger_game_event`：通过桥接数据执行 Keyboard/KeyPress/KeyRelease、Mouse、Collision、Alarm、User、Step/Other 等事件代码，不需要物理键鼠或前台焦点；Draw 事件不支持。它只执行事件代码，不更新真实按键、鼠标坐标或碰撞状态。
+- 新增 `send_game_mouse`：默认 `mode='message'` 通过窗口消息投递 move/click/wheel，不移动真实光标、不要求前台焦点；`mode='physical'` 才使用系统级注入。
+- 新增 `run_game_sequence`：组合最多 32 个 wait/input/state/capture/event 动作，总帧数上限 1800，截图最多 4 张，失败时返回已完成步骤。
+- 事件制作支持碰撞目标 `collision_object`、Keyboard/KeyPress/KeyRelease、鼠标事件编号及 DrawResize、GameStart、GameEnd 等 Other 事件。
+- 新增瓦片集与瓦片图层：`create_tileset`、`inspect_tileset`、`create_tile_layer`、`set_tilemap_cells`、`inspect_tilemap`；支持空瓦片及翻转/旋转标记。
+- 桥接新增 `event` 命令，按 `object_name` 和可选 `instance_id` 选择目标；省略 `instance_id` 时最多触发 `limit` 个实例。
+- 修正模拟键盘的语义说明：`keyboard_key_press` 只更新按住状态，不产生 KeyPress/KeyRelease 事件；事件测试改用 `trigger_game_event`。
+- 真实验收通过：瓦片值、碰撞事件、KeyPress 数据事件、窗口消息鼠标、批量序列和未处理异常捕获；默认路径不再移动真实光标或发送系统级按键。
+- 自动测试增至 88 项并全部通过；工具数增至 44。
+
+## 0.3.0.dev1 — 未发布
+
+- 新增运行观察：读取及哈希保护修改 GML、安装测试桥接、隔离 Windows VM 构建运行、游戏截图、实例状态、运行日志和按键测试，工具数增至 35。
+- 桥接控制文件改为单行 JSON，GML 侧完整读取整个文件，修复多行 JSON 无法解析的问题。
+- 桥接安装会校验并修复启动房间实例、事件列表、常驻标记及行尾/BOM 差异；启动房间变化后自动迁移桥接实例；同名普通物体给出明确错误。
+- 运行副本和存档移至用户目录，停止或过期后清理；再次运行前必须先停止并读取旧会话日志。
+- 运行响应异常会清理挂起请求，`runtime_status` 返回诊断而不是抛出内部错误；等待帧数按帧数计算超时。
+- 日志脱敏改为大小写不敏感，并覆盖存档目录和用户目录；截图读取后删除临时 PNG。
+- `inspect_game` 不再用源项目校验运行副本，桥接返回的错误按失败处理。
+- 移除测试用 `.mcp-probe-project` 绑定绕过；统一事件编号校验和实例结构；`client-config` 的 Codex 环境变量改为从同一份配置生成。
+- `client-config` 生成的单次工具调用上限改为 180 秒（Codex `tool_timeout_sec`、Claude Code `timeout`），避免 `wait_game_frames` 等待较多帧时被默认 60 秒截断。
+- 修正 Igor `Windows Run` 命令：不传 `/of`，由 Igor 在运行目录生成输出；传 `/of` 会导致 Runner 加载错误文件并退出。
+- 运行的链接检查改为 Windows reparse point 判断，覆盖控制文件、项目复制和清理，避免 GitHub Actions 临时目录的短路径被 `resolve()` 误判。
+- 新增运行、桥接修复、脱敏、清理和绑定测试，共 80 项通过。
+- 在 IDE 2026.0.0.16 / Runtime 2026.0.0.23 完成真实验收：MCP 创建控制器和桥接，Igor 编译运行，桥接就绪，截图包含 DrawGUI 内容，实例状态可读，等待 30 帧和发送方向键生效，停止后构建副本与存档均已清理。IDE 图形界面未参与本轮验收。
+
+## 0.2.0.dev2 — 未发布
+
+- 新增显示配置查询、Windows 启动显示选项、房间/相机/视口配置，工具数增至 24。
+- 支持显示名称、启动全屏、无边框、窗口大小调整许可、全屏切换许可、光标、垂直同步和像素插值。
+- 房间尺寸、相机范围和视口位置/尺寸独立设置，保留其他视口、实例和未知字段；继承显示配置拒绝修改。
+- 仅将现有 Windows 配置文件加入固定写入白名单，沿用预览、备份撤销和可选 SHA-256 检查。
+- 新增 15 项显示设置测试，扩展真实 stdio 验证，共 54 项测试通过。
+- 在 IDE 2026.0.0.16 / Runtime 2026.0.0.23 完成显示配置保存比对，以及窗口、启动全屏和无边框三种 Windows VM 场景的编译运行验收。
+
+## 0.2.0.dev1 — 未发布
+
+- 新增精灵动画查询、已有精灵速度与原点配置、帧重排和逐帧时长设置，工具数增至 21。
+- 编辑保留帧 ID、图像与未知字段，沿用预览、事务备份和撤销；可用描述文件 SHA-256 拒绝过期操作。
+- 首轮支持普通位图连续时间轴；含广播消息或时刻时不重排、不调整时长，复杂布局拒绝修改。
+- 新增精灵编辑测试，并扩展真实 stdio 协议测试。
+- 在 IDE 2026.0.0.16 / Runtime 2026.0.0.23 完成隔离项目保存及 Windows VM 编译运行；普通、小数时长及两种速度单位的实际像素采样通过。
+
+## 0.1.1 — 2026-10-17
+
+- 绑定前统一解析项目路径，修复 Windows 短路径/路径别名被误判为目录联接的问题。
+- 新增路径规范化回归测试；CI 保留两种 Python 版本的独立结果。
+- 打包日志兼容英文 Windows 的 cp1252 输出编码，避免中文日志导致构建失败。
+
+## 0.1.0 — 2026-10-17
+
+- 首个可安装版本，采用 MIT 许可证。
+- 首次公开名称确定为 MORX GMS2 MCP；安装包、命令和服务标识为 `morx-gms2-mcp`。
+- 18 个 stdio MCP 工具，支持脚本、物体、事件、房间、PNG 精灵、PCM WAV、GLSL ES 及中文分组。
+- 固定项目绑定、默认只读服务、默认预览、备份撤销、冲突检查和跨进程锁。
+- 提供 Codex / Claude Code 配置生成、独立验收场景及协议测试。
+- 已完成指定 GameMaker 2026 版本的隔离项目编译运行验收；适用边界见 README。

morx_gms2_mcp-0.4.0/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# 贡献指南
+
+欢迎提交问题和改进。报告时注明操作系统、Python、MCP SDK、IDE、Runtime 版本，以及脱敏后的最小复现；不要上传完整私有游戏或事务备份。
+
+资源描述由 GameMaker 生成的最小空白样例核对。扩展格式时保留已有字段、尾逗号兼容性和原生磁盘结构，避免依赖某个个人游戏。新操作应包含预览、实际执行、重复/无效输入测试及必要的撤销验证；涉及协议时补充真实 stdio 测试。
+
+运行相关测试使用假的构建进程和文件桥接，不会真正编译 GML。修改 `runtime.py`、`runtime_bridge.py` 或桥接安装逻辑后，还应在独立项目上用实际 Igor 编译运行一次，记录 Runtime 版本、构建日志、截图和清理结果。注意 `Windows Run` 不应传 `/of`；Igor 会在运行目录生成输出，传 `/of` 会导致 Runner 加载错误文件。没有实际打开 IDE 时，不要把命令行构建写成 IDE 图形界面验收。
+
+在仓库根目录执行测试及构建：
+
+```powershell
+python -m pip install . build
+python scripts/check_public_files.py
+python -m unittest discover -s tests -t . -v
+python -m build
+python scripts/build_release.py
+```
+
+wheel、sdist 和按白名单生成的公开源码 ZIP 位于 `dist/`。涉及新资源格式时另在独立项目中打开、保存、编译和运行，记录实际版本及可观察结果。勿把 JSON 检查通过写成 IDE 验收通过。
+
+`examples/create_demo.py --project <已绑定的空测试项目>` 可通过真实 MCP 创建验收场景，只应对独立测试项目运行；重复运行会拒绝覆盖。
+
+提交前运行 `python scripts/check_public_files.py` 并人工查看暂存差异。使用 GitHub noreply 提交邮箱；不要提交本机路径、密钥、个人配置、日志、完整游戏或实验备份。CI 同时检查已跟踪文件与提交历史，`.gitignore` 不会自动移除已经跟踪的内容。
+
+代码使用英文标识符，注释和说明优先中文。修改保持聚焦；可复用模块分为 CLI、MCP 接口、资源操作、格式、存储事务与校验。贡献须有权以本项目 MIT 许可证提供。
+
+## 发布
+
+版本号同时写在 `pyproject.toml` 和 `morx_gms2_mcp/__init__.py`，发布前更新 `CHANGELOG.md`，然后运行测试、`python -m build` 和 `python scripts/build_release.py`。
+
+PyPI 发布使用 GitHub Actions 的 OpenID Connect（Trusted Publishing），不需要保存 API token。首次发布前，在 PyPI 的 **Publishing** 页面添加一个 pending publisher：
+
+| 字段 | 值 |
+| --- | --- |
+| PyPI Project Name | `morx-gms2-mcp` |
+| Owner | `MKTLMORX` |
+| Repository name | `morx-gms2-mcp` |
+| Workflow name | `release.yml` |
+| Environment name | 留空 |
+
+配置完成后推送版本标签，例如 `v0.4.0`。`.github/workflows/release.yml` 会构建 wheel/sdist，通过 OIDC 发布到 PyPI，并创建同名 GitHub Release。也可以在 GitHub Actions 页面手动运行 `release` 工作流；手动运行只发布 PyPI，不创建 Release。工作流只申请 `id-token: write`，不读取或保存 PyPI 凭据。标签必须与包版本一致（`v0.4.0` 对应 `0.4.0`），否则构建任务会失败。

morx_gms2_mcp-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 morx-gms2-mcp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

morx_gms2_mcp-0.4.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE README.md CHANGELOG.md CONTRIBUTING.md SECURITY.md
+include .gitignore
+recursive-include tests *.py
+recursive-include examples *.py *.json *.toml
+recursive-include scripts *.py
+recursive-include .github *.yml
+global-exclude *.pyc
+prune __pycache__