amv-mcp-hub (Python)
A Model Context Protocol server that runs over stdio. It is written in Python with the standard library only, so it works on desktop Python and in Android Termux. It is the Python counterpart of the npm package amv-mcp-hub. Both expose the same core tools, so either one can back the same MCP client setup.
pip install amv-mcp-hub
amv-mcp-hub --version
amv-mcp-hub --list-tools
Use it from an MCP client
The server speaks newline-delimited JSON-RPC 2.0 on stdin/stdout and writes its logs to stderr. It opens no network port.
{
"mcpServers": {
"amv-mcp-hub": { "command": "amv-mcp-hub" }
}
}
If the console script is not on PATH, use "command": "python", "args": ["-m", "amv_mcp_hub"] instead.
Tools
| Tool | What it does |
|---|---|
run_shell_command |
Runs a command in the host shell (sh, or PowerShell on Windows). It is killed after AMV_HUB_SHELL_TIMEOUT_MS (default 120000). |
python_exec |
Runs Python code in a subprocess of the same interpreter. The tool arguments are available as __args__. Timeout is 15 s. |
smart_exec |
Routes code by language: python goes to Python, js to node (if it is installed), math to the calculator. Anything else runs in the shell. |
calc |
Arithmetic with + - * / % ^ and parentheses. It is parsed with ast, not eval, and results are formatted like JavaScript. |
format_json, text_transform, base64_encode, hash_text |
JSON pretty-printing, text case and reversal, Base64 encoding and decoding, and hashlib digests. |
generate_uuid, timestamp_convert, regex_match |
UUID v4, the current time as UTC/ISO/Unix, and regular-expression matches (Python re syntax). |
vector_cosine_similarity, vector_top_k_search |
Cosine similarity, and top-k ranking of {id, vector, text, metadata} documents. |
wasm_exec |
Runs a WASI preview-1 module given as Base64. It is listed only when the optional wasmtime package is installed (pip install "amv-mcp-hub[wasm]"). wasmtime has no Android build. |
Security
The execution tools run with the privileges of the server process and are not sandboxed. Any MCP client you connect can run commands as your user. Connect only clients you trust. The Python server has no HTTP or WebSocket interface.
Protocol
- Protocol revisions: 2025-06-18, 2025-03-26 and 2024-11-05. The server echoes the client's revision when it supports it; otherwise it offers the newest one.
- Supported methods:
initialize,ping,tools/list,tools/call, and notifications. JSON-RPC batches are also accepted. - Errors:
-32700parse error,-32600invalid request,-32601unknown method,-32602unknown tool or missing tool name,-32603tool crash. - Tool calls run on a small thread pool, so a long command does not delay
pingor other requests.
License
Apache-2.0
Metadata
Release files for amv-mcp-hub 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| amv_mcp_hub-4.0.0.tar.gz | 15.5 kB | Without provenance | Details for amv_mcp_hub-4.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| amv_mcp_hub-4.0.0-py3-none-any.whl | Python 3 | none | any | Details for amv_mcp_hub-4.0.0-py3-none-any.whl |
Total release size: 29.8 kB
Release files / amv_mcp_hub-4.0.0.tar.gz
| Download URL | amv_mcp_hub-4.0.0.tar.gz |
|---|---|
| Size | 15.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
70b3e25b445792df549669c2a52e56de41fcc2b0dcf5e837427b4a37db6448bd
|
|
BLAKE2b-256 checksum How to use checksums |
b516d0fd46b8f60da260a8a10e4ba2b140525acf0cb047ecc81479e5f78ed93d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.18
|
Release files / amv_mcp_hub-4.0.0-py3-none-any.whl
| Download URL | amv_mcp_hub-4.0.0-py3-none-any.whl |
|---|---|
| Size | 14.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
086b9b5575c0feda9a86531f6272aa02e50e823f8dd4e64ff33512a47afc7e5b
|
|
BLAKE2b-256 checksum How to use checksums |
076d71dfd9ef1b9ee75643a8422e6b9a5e1442e848e7a9b37ad8241303e101ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.18
|
Security for amv-mcp-hub 4.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.