{"id":36687743,"url":"https://github.com/converged-computing/flux-mcp","last_synced_at":"2026-01-12T11:16:18.429Z","repository":{"id":327965081,"uuid":"1113647229","full_name":"converged-computing/flux-mcp","owner":"converged-computing","description":"🌀 Agentic MCP tools for Flux Framework","archived":false,"fork":false,"pushed_at":"2026-01-01T13:03:36.000Z","size":534,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-06T13:31:14.158Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/converged-computing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":"COPYRIGHT","agents":null,"dco":null,"cla":null}},"created_at":"2025-12-10T09:13:21.000Z","updated_at":"2026-01-01T13:03:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"61fbb0f0-22b1-4ef9-8caf-e4a015f44b67","html_url":"https://github.com/converged-computing/flux-mcp","commit_stats":null,"previous_names":["converged-computing/flux-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/converged-computing/flux-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fflux-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fflux-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fflux-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fflux-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/converged-computing","download_url":"https://codeload.github.com/converged-computing/flux-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fflux-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-12T11:16:18.364Z","updated_at":"2026-01-12T11:16:18.422Z","avatar_url":"https://github.com/converged-computing.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flux-mcp\n\n\u003e 🌀 Agentic MCP tools for Flux Framework\n\n[![PyPI version](https://badge.fury.io/py/flux-mcp.svg)](https://badge.fury.io/py/flux-mcp)\n\n![img/flux-mcp-small.png](img/flux-mcp-small.png)\n\n## Related Projects\n\n- [fractale-mcp](https://github.com/compspec/fractale-mcp): (fractale) MCP orchestration (agents, databases, ui interfaces).\n- [hpc-mcp](https://github.com/converged-computing/hpc-mcp): HPC tools for a larger set of HPC and converged computing use cases.\n\n## Usage\n\nThese Flux MCP tools can be used via a standalone server, or combined with other tools.\nNote that along with flux-python (comes packaged with Flux, or `pip install flux-python==\u003cversion\u003e` you\ncan optionally install `flux-sched-py` for flux-sched functionality.\n\n### Server\n\nWe 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.\n\n#### fastmcp\n\nYou will need fastapi and fastmcp installed.\n\n```bash\n# fastmcp\npip install fastmcp fastapi\n```\n\nTo start the demo server:\n\n```bash\n# Vanilla MCP (with cli)\necho '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"initialize\", \"params\": {\"protocolVersion\": \"2024-11-05\", \"capabilities\": {}, \"clientInfo\": {\"name\": \"test\", \"version\": \"1.0\"}}}' | python3 -m flux_mcp.server | jq\n\n# Initialize and list tools\n(echo '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"initialize\", \"params\": {\"protocolVersion\": \"2024-11-05\", \"capabilities\": {}, \"clientInfo\": {\"name\": \"manual-test\", \"version\": \"1.0\"}}}';\n echo '{\"jsonrpc\": \"2.0\", \"method\": \"notifications/initialized\"}';\n echo '{\"jsonrpc\": \"2.0\", \"id\": 2, \"method\": \"tools/list\"}') | python3 -m flux_mcp.server | jq\n\n# FastMCP\npython3 -m flux_mcp.server.fastmcp\n```\n\n### Testing\n\nI will add tools to git as I write tests for them. To test, start the fastmcp server in one terminal:\n\n```bash\npython3 -m flux_mcp.server.fastmcp\n```\n\nTo test flux-sched, ensure `libreapi_cli.so` is on the `LD_LIBRARY_PATH` of the server:\n\n```bash\nexport LD_LIBRARY_PATH=/usr/lib/flux/\npython3 -m flux_mcp.server.fastmcp\n```\n\nIn another terminal, run the test. You'll need to `pip install pytest pytest-asyncio`\n\n```bash\npytest -xs tests/test_flux_validate.py\npytest -xs tests/test_flux_counts.py\npytest -xs tests/test_flux_job_delegation.py\npytest -xs tests/test_flux_job_core.py\npytest -xs tests/test_transformers.py\n\n# Requires libreapi_cli.so\npytest -xs tests/test_flux_sched.py\n\n# or\npytest -xs tests/test_*.py\n```\n\n### Tools\n\nTools to add:\n\n - flux\n   - flux-sched\n     - [ ] grow\n     - [ ] shrink\n     - [x] create resource graph\n     - [x] match allocate\n     - [x] cancel\n     - [x] partial-cancel\n     - [ ] satisfy\n   - flux-core\n     - [x] submit jobs\n     - [x] job info\n     - [x] cancel job\n     - [x] validator\n       - [x] counter\n       - [x] batch jobs\n       - [x] canonical jobspec\n       - [x] json jobspec\n   - [ ] topology?\n   - delegation\n    - [x] local flux URI\n    - [x] translation (the transformers?)\n\n## TODO\n\n- Add annotated descriptions to all functions for LLM.\n\n## License\n\nHPCIC DevTools is distributed under the terms of the MIT license.\nAll new contributions must be made under this license.\n\nSee [LICENSE](https://github.com/converged-computing/cloud-select/blob/main/LICENSE),\n[COPYRIGHT](https://github.com/converged-computing/cloud-select/blob/main/COPYRIGHT), and\n[NOTICE](https://github.com/converged-computing/cloud-select/blob/main/NOTICE) for details.\n\nSPDX-License-Identifier: (MIT)\n\nLLNL-CODE- 842614\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconverged-computing%2Fflux-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconverged-computing%2Fflux-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconverged-computing%2Fflux-mcp/lists"}