8bitworkshop MCP服务器
此包将来自8bitworkshop WebSocket桥的Atari 8位仿真器控件作为stdio上的模型上下文协议（MCP）服务器公开。它将浏览器桥中的RPC方法镜像为MCP工具。
先决条件
- Node.js 18+
- 一座正在运行的雅达利大桥。要么：
- 启动无头网桥： cd ../8bitworkshop && npm run atari-bridge，或 - 保持原始开发服务器+浏览器网桥运行并指向 ATARI_WS_URL 到它。
配置
ATARI_WS_URL（可选）：Atari网桥的WebSocket URL。默认为ws://localhost:8765.
设置和使用
cd 8bitworkshop-mcp
npm install
npm run build
node dist/index.js服务器运行后，将其连接到MCP兼容客户端（例如MCP Inspector）。如果WebSocket掉线，服务器将自动重新连接到Atari网桥。
可用工具
控制
emulator_reset,emulator_load_rom,emulator_run,emulator_stepemulator_send_key({ key_code?, char_code?, down?, shift?, ctrl?, alt?, meta?, flags? })emulator_set_joystick({ port, mask })
状态
emulator_get_state（完整快照）emulator_save_state（别名get_state)emulator_load_state({ state })
内存/I/O
emulator_read_mem({ addr, length }),emulator_write_mem({ addr, bytes_b64 })emulator_read_io({ addr }),emulator_write_io({ addr, value })
调试
emulator_set_breakpoint({ addr }),emulator_clear_breakpoint({ addr })emulator_get_trace({ last_n? })
可视化
emulator_screenshot()
所有字节有效载荷（ROM、快照、内存读取、屏幕截图）都使用base64字符串。