iphone-mcp 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- iphone_mcp-0.1.0/.github/workflows/ci.yml +20 -0
- iphone_mcp-0.1.0/.github/workflows/release.yml +72 -0
- iphone_mcp-0.1.0/.gitignore +14 -0
- iphone_mcp-0.1.0/.python-version +1 -0
- iphone_mcp-0.1.0/CHANGELOG.md +14 -0
- iphone_mcp-0.1.0/CONTRIBUTING.md +24 -0
- iphone_mcp-0.1.0/LICENSE +674 -0
- iphone_mcp-0.1.0/PKG-INFO +329 -0
- iphone_mcp-0.1.0/README.md +301 -0
- iphone_mcp-0.1.0/SECURITY.md +13 -0
- iphone_mcp-0.1.0/assets/banner.svg +119 -0
- iphone_mcp-0.1.0/assets/demo.svg +42 -0
- iphone_mcp-0.1.0/glama.json +4 -0
- iphone_mcp-0.1.0/iphone_mcp/__init__.py +3 -0
- iphone_mcp-0.1.0/iphone_mcp/__main__.py +5 -0
- iphone_mcp-0.1.0/iphone_mcp/cli.py +150 -0
- iphone_mcp-0.1.0/iphone_mcp/connection.py +383 -0
- iphone_mcp-0.1.0/iphone_mcp/paths.py +41 -0
- iphone_mcp-0.1.0/iphone_mcp/server.py +458 -0
- iphone_mcp-0.1.0/iphone_mcp/setup_wda.py +261 -0
- iphone_mcp-0.1.0/iphone_mcp/wda.py +167 -0
- iphone_mcp-0.1.0/iphone_mcp/xctest_launcher.py +164 -0
- iphone_mcp-0.1.0/pyproject.toml +58 -0
- iphone_mcp-0.1.0/server.json +45 -0
- iphone_mcp-0.1.0/tests/test_cli.py +36 -0
- iphone_mcp-0.1.0/tests/test_connection.py +50 -0
- iphone_mcp-0.1.0/tests/test_server.py +77 -0
- iphone_mcp-0.1.0/uv.lock +2512 -0
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
name: CI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
test:
|
|
10
|
+
strategy:
|
|
11
|
+
matrix:
|
|
12
|
+
os: [macos-latest, ubuntu-latest, windows-latest]
|
|
13
|
+
runs-on: ${{ matrix.os }}
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v4
|
|
16
|
+
- uses: astral-sh/setup-uv@v6
|
|
17
|
+
- run: uv sync
|
|
18
|
+
- run: uv run ruff check .
|
|
19
|
+
- run: uv run ruff format --check .
|
|
20
|
+
- run: uv run pytest -q
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
name: Release
|
|
2
|
+
|
|
3
|
+
# Push a tag like v0.2.0 (matching iphone_mcp/__init__.py and server.json) to publish
|
|
4
|
+
# the package to PyPI and the server to the official MCP Registry.
|
|
5
|
+
on:
|
|
6
|
+
push:
|
|
7
|
+
tags: ["v*"]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
pypi:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
environment: pypi
|
|
13
|
+
permissions:
|
|
14
|
+
id-token: write # PyPI trusted publishing
|
|
15
|
+
contents: read
|
|
16
|
+
steps:
|
|
17
|
+
- uses: actions/checkout@v5
|
|
18
|
+
- uses: astral-sh/setup-uv@v6
|
|
19
|
+
- name: Check versions match the tag
|
|
20
|
+
run: |
|
|
21
|
+
tag="${GITHUB_REF_NAME#v}"
|
|
22
|
+
grep -q "__version__ = \"$tag\"" iphone_mcp/__init__.py
|
|
23
|
+
python3 -c "import json,sys; d=json.load(open('server.json')); sys.exit(0 if d['version']==d['packages'][0]['version']=='$tag' else 1)"
|
|
24
|
+
- run: uv sync
|
|
25
|
+
- run: uv run pytest -q
|
|
26
|
+
- run: uv build
|
|
27
|
+
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
28
|
+
|
|
29
|
+
mcp-registry:
|
|
30
|
+
needs: pypi
|
|
31
|
+
runs-on: ubuntu-latest
|
|
32
|
+
permissions:
|
|
33
|
+
id-token: write # MCP Registry GitHub OIDC login
|
|
34
|
+
contents: read
|
|
35
|
+
env:
|
|
36
|
+
MCP_PUBLISHER_VERSION: v1.8.1
|
|
37
|
+
steps:
|
|
38
|
+
- uses: actions/checkout@v5
|
|
39
|
+
- uses: sigstore/cosign-installer@6f9f17788090df1f26f669e9d70d6ae9567deba6 # v4.1.2
|
|
40
|
+
- name: Download and verify mcp-publisher
|
|
41
|
+
run: |
|
|
42
|
+
set -euo pipefail
|
|
43
|
+
archive="mcp-publisher_linux_amd64.tar.gz"
|
|
44
|
+
base_url="https://github.com/modelcontextprotocol/registry/releases/download/${MCP_PUBLISHER_VERSION}"
|
|
45
|
+
curl --fail --location --silent --show-error --output "$archive" "$base_url/$archive"
|
|
46
|
+
curl --fail --location --silent --show-error --output "$archive.sigstore.json" "$base_url/$archive.sigstore.json"
|
|
47
|
+
cosign verify-blob \
|
|
48
|
+
--bundle "$archive.sigstore.json" \
|
|
49
|
+
--certificate-identity "https://github.com/modelcontextprotocol/registry/.github/workflows/release.yml@refs/tags/${MCP_PUBLISHER_VERSION}" \
|
|
50
|
+
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
|
|
51
|
+
"$archive"
|
|
52
|
+
tar xzf "$archive" mcp-publisher
|
|
53
|
+
- name: Wait for PyPI to serve the new version
|
|
54
|
+
run: |
|
|
55
|
+
for i in $(seq 1 30); do
|
|
56
|
+
curl -fs "https://pypi.org/pypi/iphone-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
|
|
57
|
+
sleep 10
|
|
58
|
+
done
|
|
59
|
+
exit 1
|
|
60
|
+
- run: ./mcp-publisher login github-oidc
|
|
61
|
+
- run: ./mcp-publisher publish
|
|
62
|
+
|
|
63
|
+
github-release:
|
|
64
|
+
needs: pypi
|
|
65
|
+
runs-on: ubuntu-latest
|
|
66
|
+
permissions:
|
|
67
|
+
contents: write
|
|
68
|
+
steps:
|
|
69
|
+
- uses: actions/checkout@v5
|
|
70
|
+
- run: gh release create "$GITHUB_REF_NAME" --generate-notes --title "$GITHUB_REF_NAME"
|
|
71
|
+
env:
|
|
72
|
+
GH_TOKEN: ${{ github.token }}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
3.12
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.0 – 2026-11-19
|
|
4
|
+
|
|
5
|
+
First public release.
|
|
6
|
+
|
|
7
|
+
- 18 MCP tools: screenshots scaled to tap coordinates, UI tree, tap / double-tap / long-press / tap-by-text,
|
|
8
|
+
swipe / scroll, typing, hardware buttons, lock / unlock, app list / launch / close, URLs and deep links.
|
|
9
|
+
- Connection over USB or Wi-Fi, with automatic fallback: Xcode tunnel → usbmux → last known Wi-Fi IP.
|
|
10
|
+
- Keep-awake: the screen does not auto-lock while an agent is connected (invisible off-screen touch, no settings changed).
|
|
11
|
+
- `iphone-mcp setup` builds and signs WebDriverAgent with your own Apple ID (macOS + Xcode).
|
|
12
|
+
- Linux and Windows: launch WebDriverAgent without Xcode through pymobiledevice3's no-root tunnel;
|
|
13
|
+
`setup --prebuilt` / `setup --ipa` for installing a signed WebDriverAgent.
|
|
14
|
+
- `iphone-mcp doctor` checks the whole chain.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Contributing
|
|
2
|
+
|
|
3
|
+
Thanks for helping! Bug reports, device/iOS compatibility notes and pull requests are all welcome.
|
|
4
|
+
|
|
5
|
+
## Development setup
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
git clone https://github.com/DamienDrash/iphone-mcp.git
|
|
9
|
+
cd iphone-mcp
|
|
10
|
+
uv sync
|
|
11
|
+
uv run pytest
|
|
12
|
+
uv run ruff check . && uv run ruff format --check .
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Try your changes against a real device with `uv run iphone-mcp doctor` and `uv run iphone-mcp start`,
|
|
16
|
+
or drive the server from any MCP client with `uv --directory /path/to/iphone-mcp run iphone-mcp`.
|
|
17
|
+
|
|
18
|
+
## Guidelines
|
|
19
|
+
|
|
20
|
+
- Keep tools small and predictable; return short, factual text the agent can act on.
|
|
21
|
+
- Never add anything that types passwords, passcodes or payment data on the user's behalf.
|
|
22
|
+
- Device-specific behaviour (iOS version, locale) belongs behind identifiers, not on-screen text.
|
|
23
|
+
- When you report a bug, include the output of `uv run iphone-mcp doctor` and the end of
|
|
24
|
+
`~/Library/Logs/iphone-mcp/wda.log` (remove anything personal first).
|