🚀 MCP 服务器 - iOS 模拟器控制工具

MCP 服务器是一个基于 idb 工具的 iOS 模拟器自动化控制服务。它借助自然语言处理技术，把用户指令转化为可执行的操作命令，进而实现对 iOS 模拟器的全面掌控。

🚀 快速开始

安装依赖项

在开始使用前，请确保你已经安装了以下工具：

• Node.js（推荐版本 14 或以上）
• idb 命令行工具

克隆仓库

git clone https://github.com/your-repository/mcp-server-simulator-ios-idb.git
cd mcp-server-simulator-ios-idb

安装依赖

运行下面的命令来安装项目所需的 npm 包：

npm install

启动服务器

使用 Node.js 执行主程序文件以启动服务器：

node index.js

✨ 主要特性

该服务器提供了丰富的 iOS 模拟器控制功能，主要涵盖以下几个方面：

基本操作

1. 模拟器会话管理
   • 创建、激活和终止模拟器会话
   • 列出所有可用的 iOS 模拟器
2. 应用生命周期
   • 启动、停止和重启应用程序
   • 查看正在运行的应用程序
   • 分析应用性能数据
3. 文件系统操作
   • 上传和下载文件到模拟器
   • 创建、删除和遍历目录
   • 复制和移动文件
4. 进程管理
   • 列出所有运行的进程
   • 启动和停止特定进程
   • 查看进程详细信息

高级功能

1. 调试与日志
2. 图形界面操作
   • 捕获屏幕截图
   • 记录屏幕视频
   • 模拟触摸事件
3. 权限管理
   • 请求和授予应用程序权限
   • 管理钥匙链访问
   • 监控网络流量
4. 模拟环境

💻 使用示例

基础用法

# 创建新的模拟器会话
curl -X POST http://localhost:3000/api/simulator/session

# 启动应用
curl -X POST http://localhost:3000/api/app/start \
     -d '{"bundleId":"com.example.app"}'

# 捕获截图
curl -X GET http://localhost:3000/api/capture/screenshot

📚 详细文档

架构设计

核心组件

1. IDBManager
   • 负责与 iOS 模拟器进行底层通信
   • 执行 idb 工具的所有命令操作
   • 管理模拟器的生命周期和会话状态
2. NLParser
   • 接收并解析用户提供的自然语言指令
   • 将其转换为结构化的命令请求
   • 支持复杂的多步骤操作
3. MCPOrchestrator
   • 协调各个组件之间的交互
   • 分发命令到相应的执行模块
   • 处理异步操作和错误处理

适配器与插件

• idb CLI Adapter：支持 idb 命令行工具的所有功能
• HTTP Adapter：提供 RESTful API 接口
• WebSocket Plugin：实现实时通信能力

MCP 集成

快速上手

1. 安装并启动服务器
2. 配置客户端 SDK
3. 发送命令进行测试

示例配置

const mcp = new MCPClient('ws://localhost:3001');

async function launchApp() {
    try {
        await mcp.sendCommand({
            type: 'app_launch',
            payload: { bundleId: 'com.example.app' }
        });
        console.log('应用已启动');
    } catch (error) {
        console.error('启动失败:', error);
    }
}

🤝 项目贡献

如何贡献

1. 提交问题报告
2. 创建功能请求
3. 参与代码审查
4. 贡献代码修改

贡献者

感谢所有为该项目做出贡献的开发者和用户。

📄 许可证

本项目遵循 MIT 许可证，具体内容如下：

MIT License

Copyright (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

📞 联系方式

项目维护者

• 开发者: [你的名字]
  邮箱: your.email@example.com

问题反馈

欢迎通过 GitHub 提交 issue 或 pull request，与我们共同完善这个项目。