Simctl Mcp
概要
simctl-mcpとは?
simctl-mcpは、ユーザー### ambarによって作成されたGitHub上の公開リポジトリです。このプロジェクトは、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リポジトリの「Issues」タブに移動し、遭遇した問題の詳細を含む新しい問題を提出することで報告できます。
詳細
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)
サーバー設定
{
"mcpServers": {
"simctl-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ambar--simctl-mcp--simctl-mcp",
"pnpm run start"
],
"env": {}
}
}
}