Skip to main content
Glama
Message From Aliens MCP

Message From Aliens MCP

by windlandneko

Message From Aliens MCP

通过四个 MCP 工具游玩 Steam 独立游戏《外星来信》(面向 Windows)。

启动

安装游戏、uv 和 .NET 10 SDK,在项目目录打开 PowerShell:

uv run build.py --game 'D:\SteamLibrary\steamapps\common\Message From Aliens'
uv run run.py

游戏将会被复制到 game/ 应用补丁;--game 也接受游戏 .exe 路径;游戏更新后用 --output game-new 重新构建。

默认后台运行,独立存档位于 saves/default/。如果需要窗口或另一份存档:

uv run run.py --window --save 'D:\AlienSaves\new-run'

Related MCP server: dsh-cua

连接 MCP

在 Harness 端添加 stdio 服务,把路径改成项目的实际位置:

{
  "mcpServers": {
    "alien": {
      "command": "uv",
      "args": ["run", "--project", "C:\\mfa-mcp", "C:\\mfa-mcp\\mcp.py"]
    }
  }
}

先启动游戏,再连接客户端,需要调试日志时给 mcp.py 加 --log logs/tools.jsonl。

工具

参数

用途

click

{x,y}

左键操作并返回画面

rclick

{x,y}

右键操作并返回画面

note

{notes:[{id,text}]}

注释并返回画面(空数组读取当前画面)

render

{ids:["AB","94"]}

返回字形的 PNG 图片

坐标从左上角 (0,0) 开始,范围为 24×9。每条注释最多 20 个字符,空文本清除注释。为了节省词元,字形 ID 为常见的两个英文字母或两个数字,区分大小写,在 GPT 分词器里均为单个词元。

首次读取画面时附带成就列表和解锁状态,新成就触发时返回的结果里带有显示编号、成就名称及说明。成就记录随独立存档保留。

退出、外链和设置变化同样以文字事件返回,退出和外链不需要处理,会自动阻拦。

文件结构

  • mcp.py、mcp_tools/:工具声明、调用、网格及图片输出、stdio 协议。

  • build.py、native/:Unity Mono 桥接及补丁。

  • run.py:启动游戏、选择存档和端口。

  • font/:字形字体及映射数据。

构建需要游戏目录中的 Managed/Assembly-CSharp.dll,支持 Unity Mono 版。启动失败时查看存档目录的 player.log。

默认桥接地址为 127.0.0.1:8765。多开时分别设置 run.py --port 8766 和 mcp.py --bridge http://127.0.0.1:8766(同一端口已有游戏的话启动器只连接相同存档)。

如果日志提示 HttpListenerException: Access is denied,在管理员 PowerShell 中为当前用户配置端口权限再正常启动:

netsh http add urlacl url=http://127.0.0.1:8765/ user="$env:USERDOMAIN\$env:USERNAME"

许可

代码采用 MIT。font/ 字体及字形素材沿用原声明,见 THIRD_PARTY_NOTICES.md。

Available Tools

4 tools
clickB

Left-click. Returns the screen.

Inputs: x (required), y (required).

noteB

Set annotations. Empty text clears; notes:[] reads the screen.

Inputs: notes (required).

rclickC

Right-click. Returns the screen.

Inputs: x (required), y (required).

renderC
Read-only

Return glyphs as a PNG, preserving order and repetitions.

Inputs: ids (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 4 tools

    Disambiguation4/5

    click vs rclick are clearly distinguished by name, and render is a distinct glyph-to-PNG operation. The 'note' tool is a slight exception since it overloads three behaviors (set, clear, read), and both click tools also 'return the screen', which blurs boundaries with note's read mode.

    Naming Consistency3/5

    All names are short lowercase imperatives, which is readable, but the pattern is inconsistent: 'click' is spelled out while 'rclick' is abbreviated, and 'note'/'render' are nouns-as-verbs that don't align with the click pair.

    Tool Count4/5

    Four tools is a well-scoped surface for a narrow screen/glyph interaction server, with each tool earning a place. It sits at the thin end but doesn't feel incomplete by count alone.

    Completeness3/5

    The surface covers clicking, annotating, and rendering, but lacks obvious interaction operations like scroll, drag, type, or hover for a screen-driven domain. The read-screen capability is hidden inside 'note' rather than being a first-class tool.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI clients on Windows to control the local mouse, keyboard, and screen understanding via MCP stdio, allowing automated workflows like viewing the screen, locating elements, clicking, typing, and verifying results.
      1
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Windows computer-use MCP server: accessibility-first element actions (UIA), UI read as diffed text trees instead of screenshots, guarded raw input, and a cross-session arbiter that yields to the human. 19 tools.
      19
      104 PyPI
      9
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables any local MCP agent host to observe and operate a real Stardew Valley game through 28 tools covering world snapshots, screenshots, movement, inventory, menus, buying/shipping, containers, crafting, placing, fishing, combat and save loading. Writes run only through normal in-game flows under a single-writer control lease with ledger-based idempotency, epoch invalidation, fail-safe release on disconnect, and human takeover via web console or hotkey.
      1
      MIT