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.
@@ -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,14 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.pyc
4
+ .pytest_cache/
5
+ .ruff_cache/
6
+ dist/
7
+ build/
8
+ vendor/
9
+ *.xcresult
10
+ .DS_Store
11
+
12
+ # local project tracking (Leitstand)
13
+ ROADMAP.md
14
+ PO-STATUS.md
@@ -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).