Ios Simulator MCP

🚀 iOS 模擬器 MCP 服務器

這是一個用於與 iOS 模擬器交互的模型上下文協議（MCP）服務器。藉助該服務器，您能夠獲取模擬器的相關信息、控制 UI 交互並檢查 UI 元素，從而實現與 iOS 模擬器的交互。

點擊查看

https://github.com/user-attachments/assets/453ebe7b-cc93-4ac2-b08d-0f8ac8339ad3

🚀 快速開始

在使用本服務器前，您需要滿足以下先決條件：

• Node.js 版本 >= 8.0.0
• npm 或 yarn 包管理器
• 安裝並配置了 iOS 模擬器工具鏈

✨ 主要特性

• 廣泛兼容：支持多種 iOS 模擬器版本。
• 高效管理：具備高效的狀態管理和上下文跟蹤能力。
• 靈活處理：擁有靈活的事件處理機制。
• 調試便利：提供詳細的日誌記錄和調試選項。

📦 安裝指南

使用 Cursor 進行安裝

1. 使用 NPX 快速安裝：

   npx ios-simulator-mcp --install
   

2. 本地構建和安裝（可選）：

   git clone https://github.com/joshuayoes/ios-simulator-mcp.git
   cd ios-simulator-mcp
   npm install
   npm run build
   

使用 Claude Code 進行安裝

1. 使用 NPX 快速添加服務器：

   claude mcp add ios-simulator --command npx --args "-y,ios-simulator-mcp"
   

2. 本地構建和添加（可選）：

   git clone https://github.com/joshuayoes/ios-simulator-mcp.git
   cd ios-simulator-mcp
   npm install
   npm run build
   claude mcp add ios-simulator --command node --args "/full/path/to/build/index.js"
   

💻 使用示例

基礎用法

const { SimulatorMcpServer } = require('ios-simulator-mcp');

// 創建服務器實例
const server = new SimulatorMcpServer({
  port: 3001,
  mode: 'development',
  logging: true
});

// 啟動服務器
server.start().then(() => {
  console.log('服務器已啟動並在端口 3001 上監聽');
}).catch(err => {
  console.error('啟動服務器時出錯:', err);
});

高級用法

const { SimulatorMcpServer } = require('ios-simulator-mcp');

// 創建並配置服務器實例
const server = new SimulatorMcpServer({
  port: 3001,
  events: {
    'custom-event': (context) => {
      // 自定義事件處理邏輯
      console.log('檢測到自定義事件:', context);
      return { status: 'handled', response: '自定義事件已處理' };
    }
  }
});

// 啟動服務器
server.start().then(() => {
  console.log('服務器已啟動並在端口 3001 上監聽');
}).catch(err => {
  console.error('啟動服務器時出錯:', err);
});

📚 詳細文檔

功能

• 獲取當前啟動的 iOS 模擬器 ID
• 與模擬器 UI 交互：
  • 獲取當前正在處理的活動（action）
  • 獲取有關當前活動的上下文信息
  • 控制對當前活動的響應
• 檢查和修改模擬器狀態
• 收集和分析模擬器性能數據

配置

環境變量

可以通過設置以下環境變量來配置 MCP 服務器的行為：

📄 許可證

本項目採用 MIT 許可證。