Skip to main content
Glama
Message From Aliens MCP

Message From Aliens MCP

by windlandneko
README.md
# Message From Aliens MCP

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

## 启动

安装游戏、[uv](https://docs.astral.sh/uv/getting-started/installation/) 和 [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0),在项目目录打开 PowerShell:

```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/`。如果需要窗口或另一份存档:

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

## 连接 MCP

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

```json
{
  "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 中为当前用户配置端口权限再正常启动:

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

## 许可

代码采用 [MIT](LICENSE)。`font/` 字体及字形素材沿用原声明,见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

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