内容
# dosbox-mcp
MCP 服务器，用于 [dosbox-automation](https://dosbox-automation.org)：
通过 AI 代理驱动 DOS 机器。
dosbox-automation 是 DOSBox 的一个分支，内置了自动化 API。
该桥接器连接任何支持 MCP 的代理运行时（Claude Code 及类似项目）到正在运行的模拟器。代理可以向 DOS 程序输入文本，读取屏幕，捕获帧和视频，运行沙盒 Lua 脚本，并检查内存：所有自动化 API 提供的内容，作为 MCP 工具。
## 快速入门
1. 安装 dosbox-automation 并启用 API 后启动。手册涵盖了所有平台的设置。
2. 将桥接器添加到您的 MCP 客户端。对于 Claude Code：
```bash
claude mcp add dosbox -- uvx dosbox-mcp
```
或在 JSON MCP 配置中：
```json
{
"mcpServers": {
"dosbox": { "command": "uvx", "args": ["dosbox-mcp"] }
}
}
```
`pipx install dosbox-mcp` 或 `pip install dosbox-mcp` 均可；命令均为 `dosbox-mcp`。
就这样。桥接器会找到正在运行的模拟器，检查其功能，并注册匹配的工具。向您的代理请求 `bridge_status` 以确认连接。
## 配置
可选。编写注释配置文件以调整端口，按需启动模拟器，或限制代理可以执行的操作：
```bash
dosbox-mcp setup --init
```
生成的配置文件中的注释解释了每个设置。环境变量 `DOSBOX_API_URL` 和 `DOSBOX_API_TOKEN` 会覆盖它。桥接器仅与回环地址通信；它不会连接到远程机器。
## 代理可访问的内容
用于会话控制、屏幕文本和捕获、视频录制、Lua 脚本编写、键盘和鼠标输入以及内存访问的工具。您可以选择代理的权限范围，从只读观察到完全控制。
## 开放协议
该桥接器与模拟器之间的协议在 [PROTOCOL.md](PROTOCOL.md) 中定义，并独立于版本进行管理。dosbox-automation 是参考实现；任何支持该协议的 DOSBox 变体均可与此桥接器配合使用。
## 内含内容
与它驱动的游戏一样，本项目也附带了文档。`feelies/` 文件夹包含手册、每个工具的参考卡、安装指南和技术支持页面。
## 需求
- Python 3.11 或更新版本
- 在同一台机器上运行的 dosbox-automation（0.84-da2 或更新版本）
## 许可证
GPL-2.0-or-later。参见 LICENSE。协议规范（PROTOCOL.md）采用 CC-BY-SA-4.0 许可证。
---
本项目使用工具辅助开发，但由人类开发者测试、审查和签署。
