Metadata-Version: 2.5
Name: amgi-mcp
Version: 0.1.0
Summary: Amgi MCP server — Python shim for uvx. Launches the bundled Amgi helper.
Project-URL: Homepage, https://github.com/bagumamartin/amgi
Project-URL: Repository, https://github.com/bagumamartin/amgi
Author: Amgi
License: AGPL-3.0
Keywords: amgi,anki,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# amgi-mcp (Python shim for `uvx`)

This is a tiny Python wrapper that makes the Amgi MCP server runnable via [`uvx`](https://docs.astral.sh/uv/guides/tools/#running-tools-with-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 `exec`s it, forwarding stdio.

## Install / run

```sh
# Try without installing (uv will fetch from PyPI once published):
uvx amgi-mcp --help

# Or install as a persistent tool:
uv tool install amgi-mcp
amgi-mcp --help
```

Local development (no PyPI):

```sh
uvx --from ./python amgi-mcp --help
uv tool install --from ./python amgi-mcp
```

All arguments are passed through, so tier/profile flags still work:

```sh
amgi-mcp --help
amgi-mcp --profile work
```
