the_auto MCP 服务

这是一个将 the_auto Windows GUI自动化应用包装成MCP (Model Context Protocol) 服务的实现。

功能特性

• Windows GUI自动化：通过自然语言控制Windows应用程序
• 多任务管理：支持并发执行多个自动化任务
• 实时状态监控：提供任务执行状态和日志信息
• 应用程序管理：自动发现和管理系统中的应用程序

安装和设置

提示：也可以直接运行the_final_show进行GUI自动化操作，LLM中默认调用的是谷歌的模型，可以根据需求进行更改

1. 安装依赖

简化版MCP服务器只需要the_auto应用的基础依赖：

bash
pip install -r requirements.txt

注意：简化版不需要额外的MCP库，使用标准JSON-RPC协议。

2. 启动MCP服务器

推荐使用启动脚本（会自动选择最佳版本）：

bash
python start_mcp_server.py

或者直接运行简化版（推荐）：

bash
python simple_mcp_server.py

或者运行完整版（需要MCP库）：

bash
python mcp_server.py

MCP工具接口

1. execute_automation_task

执行Windows GUI自动化任务。

参数：

• prompt (string): 任务描述，例如："打开Word并输入一些文本"

示例：
json
{
"prompt": "打开记事本并输入Hello World"
}

2. get_task_status

获取指定任务的状态和日志信息。

参数：

• task_id (integer): 任务ID

示例：
json
{
"task_id": 1
}

3. stop_task

停止指定的任务。

参数：

• task_id (integer): 要停止的任务ID

示例：
json
{
"task_id": 1
}

4. list_tasks

列出所有当前和历史任务。

参数： 无

5. get_available_apps

获取系统中可用的应用程序列表。

参数： 无

使用示例

通过MCP客户端调用

python

执行自动化任务

result = await client.call_tool("execute_automation_task", {
"prompt": "打开Word并创建一个新文档"
})

获取任务状态

status = await client.call_tool("get_task_status", {
"task_id": 1
})

列出所有任务

tasks = await client.call_tool("list_tasks", {})

测试MCP服务器

运行测试脚本验证服务器功能：

bash
python test_simple_mcp.py

配置文件示例

在MCP客户端配置文件中添加：

json
{
"mcpServers": {
"the_auto_mcp": {
"command": "python",
"args": ["path/to/the_auto/mcp_server.py"],
"env": {
"PYTHONPATH": "path/to/the_auto"
}
}
}
}

支持的应用程序

该服务可以自动发现和管理以下类型的应用程序：

• Microsoft Office套件 (Word, Excel, PowerPoint等)
• 系统工具 (记事本, 计算器等)
• 第三方应用程序 (如果已安装)

注意事项

1. Windows环境：此服务仅在Windows环境下运行
2. 管理员权限：某些操作可能需要管理员权限
3. 应用程序兼容性：并非所有应用程序都支持自动化操作
4. 任务超时：长时间运行的任务可能会被系统自动终止

故障排除

常见问题

1. 依赖安装失败

   • 确保使用Python 3.7+
   • 检查网络连接
   • 尝试使用管理员权限安装

2. 应用程序无法启动

   • 检查应用程序是否已安装
   • 确认应用程序路径正确
   • 检查系统权限

3. MCP连接失败

   • 确认MCP服务器正在运行
   • 检查配置文件路径
   • 验证Python环境

日志文件

• task_log.txt: 任务执行日志
• task_*_llm_log.txt: 特定任务的LLM交互日志

开发信息

• 版本: 1.0.0
• Python版本: 3.7+
• 依赖: pywinauto, psutil, pywin32, mcp
• 许可证: 遵循原项目许可证

贡献欢迎提交Issue和Pull Request来改进这个MCP服务。

看起来您提供的内容已经是中文了，因此不需要翻译。如果您有具体的英文技术文档需要翻译，请提供文档的具体内容，我将根据您的要求进行翻译。