Skip to main content

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: -32700 parse error, -32600 invalid request, -32601 unknown method, -32602 unknown tool or missing tool name, -32603 tool crash.
  • Tool calls run on a small thread pool, so a long command does not delay ping or 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)

Source distribution for amv-mcp-hub 4.0.0
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)

Table of built distributions (wheels) for amv-mcp-hub 4.0.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

4.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page