Simctl Mcp
概览
什么是 simctl-mcp？
simctl-mcp 是一个托管在 GitHub 上的公共仓库，由用户 ### ambar 创建。该项目旨在提供一个命令行界面，用于管理和控制 iOS 模拟器。它简化了与模拟器的交互过程，使开发人员能够自动化任务并优化他们的开发工作流程。
simctl-mcp 的特点
- 命令行界面：提供用户友好的命令行界面，用于管理 iOS 模拟器。
- 自动化：能够自动化常见任务，如启动模拟器、安装应用程序和运行测试。
- 跨平台兼容性：在不同操作系统之间无缝工作，使所有开发人员都能访问。
- 开源：作为一个公共仓库，允许开发人员根据自己的需求贡献、修改和增强该工具。
- 文档：提供全面的文档，帮助用户有效地理解如何使用该工具。
如何使用 simctl-mcp
- 安装：使用以下命令从 GitHub 克隆仓库：
git clone https://github.com/ambar/simctl-mcp.git - 导航到目录：切换到项目目录：
cd simctl-mcp - 运行命令：使用命令行界面管理模拟器。例如，要列出所有可用的模拟器，可以运行：
./simctl list - 自动化任务：创建脚本以使用 simctl-mcp 提供的命令自动化重复任务。
常见问题解答
simctl-mcp 是用什么编程语言编写的？
simctl-mcp 主要是用 Python 编写的，使得熟悉该语言的开发人员能够轻松贡献。
simctl-mcp 是否与所有版本的 iOS 兼容？
是的，simctl-mcp 旨在与各种版本的 iOS 模拟器兼容，确保在不同的开发环境中都能正常工作。
我可以为 simctl-mcp 贡献吗？
当然可以！由于这是一个开源项目，欢迎贡献。您可以分叉仓库，进行更改，并提交拉取请求。
我在哪里可以找到 simctl-mcp 的文档？
文档通常在仓库内部提供，通常在 README.md 文件或专门的 docs 文件夹中找到。
我该如何报告 simctl-mcp 中的问题或错误？
您可以通过导航到 GitHub 仓库中的“问题”选项卡，提交一个新问题，详细说明您遇到的问题。
详情
simctl-mcp
A Model Context Protocol server implementation for iOS Simulator control.
Config
.cursor/mcp.json or .vscode/mcp.json:
{
"mcpServers": {
"simctl-mcp": {
"command": "npx",
"args": ["-y", "simctl-mcp"]
}
}
}
Prompts
Some examples of prompts:
- What operations does the simulator support?
- Open shortcuts://
- What is the bundle ID of the "Settings" app?
- Set clipboard content to: Hello
- What is the simulator SDK version?
- Generate an Appium connection string for the "Settings" app
Usage
The server can be started in two modes:
- STDIO Mode (default)
- HTTP Server Mode
STDIO Mode
In STDIO mode, the server communicates through standard input/output streams.
npx simctl-mcp
HTTP Server Mode
In HTTP server mode, the server listens for HTTP connections on a specified port.
### Start with default port (8081)
npx simctl-mcp --http
### Start with custom port using --port flag
npx simctl-mcp --http --port 3000
### Start with custom port using environment variable
PORT=3000 npx simctl-mcp --http
Tools
Device Management:
- Create new simulator devices
- Delete existing devices
- Boot devices
- Shutdown devices
- List all available devices
- List available device types
- List available runtimes
App Management:
- Install apps
- Uninstall apps
- Launch apps
- Terminate running apps
- Get app container path
- Get app information
- List installed apps
App Permissions:
- Grant permissions to apps
- Revoke app permissions
- Reset all app permissions
System Features:
- Open URLs in simulator
- Add media files
- Get/Set environment variables
- Get/Set appearance (light/dark mode)
- Send simulated push notifications
Certificate & Security:
- Add root certificates
- Add regular certificates
- Reset keychain
Media & Content:
- Take screenshots
- Get/Set pasteboard content (clipboard)
Server配置
{
"mcpServers": {
"simctl-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ambar--simctl-mcp--simctl-mcp",
"pnpm run start"
],
"env": {}
}
}
}
