amgi-mcp (Python shim for uvx)
This is a tiny Python wrapper that makes the Amgi MCP server runnable via uvx — the pattern many MCP clients expect:
Command: uvx
Parameters: amgi-mcp
The Swift helper is still the real server; this package just finds the bundled binary at /Applications/AmgiApp.app/Contents/Helpers/amgi-mcp (or the dev helpers in ~/bin, /usr/local/bin, DerivedData) and execs it, forwarding stdio.
uvx (uv tool run) holds the uv cache lock for the lifetime of the server (astral-sh/uv#15990). With several clients all using uvx the spawns serialize and can hit the 10 s handshake timeout. For multi-client / daily use install once persistently.
Install / run
# One-off / trial — no install, uses cached env after first run:
uvx amgi-mcp --help
# Pin for reproducibility:
uvx amgi-mcp==1.0.2 --help
# Daily / multi-client — persistent, fastest, no cache-lock contention:
uv tool install amgi-mcp
amgi-mcp --help
# Update the persistent install:
uv tool upgrade amgi-mcp
Local development (no PyPI):
uvx --from ./python amgi-mcp --help
uv tool install --from ./python amgi-mcp
All arguments are passed through, so tier/profile flags still work:
amgi-mcp --help
amgi-mcp --profile work
Troubleshooting: uvx timeout or Waiting to acquire lock
If several AI clients launch uvx amgi-mcp at once and one times out, either switch that client to the persistent amgi-mcp command or re-run the failing uvx once - uv cache is shared and uvx retains a shared lock for the server lifetime. uv tool install avoids the lock entirely.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file amgi_mcp-1.0.2.tar.gz.
File metadata
- Download URL: amgi_mcp-1.0.2.tar.gz
- Upload date:
- Size: 3.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f55269e3e13c62a9fc07b10949f21498a86541942c137f7696f5759510d42a14
|
|
| MD5 |
2e2fd0e90912b9d625f2d8d12d571eeb
|
|
| BLAKE2b-256 |
3d23159bb7b6dac72eec7e19ed49a4492d1c74d6596df24c3fc8cd6c8d52a09a
|
Provenance
The following attestation bundles were made for amgi_mcp-1.0.2.tar.gz:
Publisher:
publish-pypi.yml on bagumamartin/amgi
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
amgi_mcp-1.0.2.tar.gz -
Subject digest:
f55269e3e13c62a9fc07b10949f21498a86541942c137f7696f5759510d42a14 - Sigstore transparency entry: 2581550785
- Sigstore integration time:
-
Permalink:
bagumamartin/amgi@23ce4529438023d18fc32d4300e6b32cd2024400 -
Branch / Tag:
refs/tags/amgi-mcp-v1.0.2 - Owner: https://github.com/bagumamartin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@23ce4529438023d18fc32d4300e6b32cd2024400 -
Trigger Event:
push
-
Statement type:
File details
Details for the file amgi_mcp-1.0.2-py3-none-any.whl.
File metadata
- Download URL: amgi_mcp-1.0.2-py3-none-any.whl
- Upload date:
- Size: 3.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
487798f72989b86623ad1817234e94ef8619fc6033f968b0348116e88b42a639
|
|
| MD5 |
22c1740888556b4287cf27f5461fd1ad
|
|
| BLAKE2b-256 |
34a090d51acc4d4b150587a2b9f638d1367030e5c61ecd7dbc8a8c8aaa2dc1a9
|
Provenance
The following attestation bundles were made for amgi_mcp-1.0.2-py3-none-any.whl:
Publisher:
publish-pypi.yml on bagumamartin/amgi
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
amgi_mcp-1.0.2-py3-none-any.whl -
Subject digest:
487798f72989b86623ad1817234e94ef8619fc6033f968b0348116e88b42a639 - Sigstore transparency entry: 2581550788
- Sigstore integration time:
-
Permalink:
bagumamartin/amgi@23ce4529438023d18fc32d4300e6b32cd2024400 -
Branch / Tag:
refs/tags/amgi-mcp-v1.0.2 - Owner: https://github.com/bagumamartin
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@23ce4529438023d18fc32d4300e6b32cd2024400 -
Trigger Event:
push
-
Statement type:
