hpc-mcp
🌀 Agentic MCP tools for High Performance Computing
Related Projects
- flux-mcp: MCP functions for Flux Framework.
- fractale: (fractale) MCP orchestration (agents, databases, ui interfaces).
Usage
This is a library of MCP tools (functions, prompts, and resources) intended for converged computing and HPC use cases. A demo server is provided here, and largely functions are expected to be used a-la-carte as imports to other libraries. We welcome contributions of all functions types that are related to HPC, converged computing, and science. These MCP tools can be used via a standalone server, or combined with other tools.
Server
We provide examples for fastmcp and a vanilla mcp (stdio) setup. Neither requirements are added to the install directly, so it's up to the user (you) to install. Tests are performed with fastmcp (TBA)
fastmcp
You will need fastapi and fastmcp installed.
# fastmcp
pip install fastmcp fastapi
To start the demo server:
# Vanilla MCP (with cli)
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' | python3 -m hpc_mcp.server | jq
# Initialize and list tools
(echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "manual-test", "version": "1.0"}}}';
echo '{"jsonrpc": "2.0", "method": "notifications/initialized"}';
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}') | python3 -m hpc_mcp.server | jq
# FastMCP
python3 -m hpc_mcp.server.fastmcp
Testing
I will add tools to git as I write tests for them. To test, start the fastmcp server in one terminal:
python3 -m hpc_mcp.server.fastmcp
In another terminal, run the test. You'll need to pip install pytest pytest-asyncio
pytest -xs tests/test_build_docker.py
# or
pytest -xs tests/test_*.py
TODO
- Add annotated descriptions to all functions for LLM.
Tools to add:
- helpers
- debug
- result parser (regular expressions)
- kubernetes
- deploy job
- deploy minicluster
License
DevTools is distributed under the terms of the MIT license. All new contributions must be made under this license.
See LICENSE, COPYRIGHT, and NOTICE for details.
SPDX-License-Identifier: (MIT)
LLNL-CODE- 842614
Metadata
Release files for hpc-mcp 0.0.18
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 |
|---|---|---|---|---|
| hpc_mcp-0.0.18.tar.gz | 38.9 kB | Without provenance | Details for hpc_mcp-0.0.18.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hpc_mcp-0.0.18-py3-none-any.whl | Python 3 | none | any | Details for hpc_mcp-0.0.18-py3-none-any.whl |
Total release size: 85.3 kB
Release files / hpc_mcp-0.0.18.tar.gz
| Download URL | hpc_mcp-0.0.18.tar.gz |
|---|---|
| Size | 38.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e98fed9259b3fa3c66c5415f7068fb972aaf78dd79f8cdfc7cfb5b3229404717
|
|
BLAKE2b-256 checksum How to use checksums |
35fadff2bf318e2847d39da290b0f3e826c03157b30d2e14c96456cf7b6e6fac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.2
|
Release files / hpc_mcp-0.0.18-py3-none-any.whl
| Download URL | hpc_mcp-0.0.18-py3-none-any.whl |
|---|---|
| Size | 46.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
563e734cdec67aaa19c3632c5bff0d66a6469b01cde57ed6bf2bb7621273d06a
|
|
BLAKE2b-256 checksum How to use checksums |
2fb006db452b1c9cd9ce78c37c4e6fd913f40aa1103d26f04fc8acd4d144e523
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.2
|
Security for hpc-mcp 0.0.18
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.