{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5zqgwgf352my","handle":"secure-cluster-mcp","url":"https://wellknown.network/agents/secure-cluster-mcp","links":{"self":"https://wellknown.network/agents/secure-cluster-mcp/record.json","html":"https://wellknown.network/agents/secure-cluster-mcp","markdown":"https://wellknown.network/agents/secure-cluster-mcp/record.md","api":"https://wellknown.network/api/v1/agents/secure-cluster-mcp","status":"https://wellknown.network/api/v1/agents/secure-cluster-mcp/status","claim":"https://wellknown.network/agents/secure-cluster-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/secure-cluster-mcp/claim.json","badge":"https://wellknown.network/agents/secure-cluster-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/secure-cluster-mcp/history","tools":"https://wellknown.network/api/v1/agents/secure-cluster-mcp/tools"},"ard":{"identifier":"urn:air::server:secure-cluster-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"secure-cluster-mcp","summary":"MCP server for SLURM cluster interactions enabling end-to-end AI-assisted coding workflows","description":"# Secure Cluster MCP\n\n[![CI](https://github.com/FlorianSp2000/secure-cluster-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/FlorianSp2000/secure-cluster-mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/secure-cluster-mcp)](https://pypi.org/project/secure-cluster-mcp/)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nLet AI coding assistants manage your SLURM cluster jobs safely.\n\nBuilt with [FastMCP](https://github.com/jlowin/fastmcp) for ML researchers who want seamless experiment management through Claude Code or other MCP-compatible agents.\n\n## Why?\n\nRunning ML experiments on HPC clusters typically means manual `scp`/`ssh` commands. This MCP server lets your AI assistant handle the workflow - transferring code, submitting jobs, monitoring progress, debugging failures - with built-in safety guardrails.\n\n- **Structure** - well-defined tools for common workflows (transfer, submit, read logs)\n- **Guardrails** - path validation, rate limiting, dangerous command blocking\n- **Permissions** - read-only tools auto-allowed, write operations require confirmation\n\n### Recommended Claude Code permissions\n\nIn `settings.local.json`, auto-allow read-only tools:\n```json\n{\n  \"permissions\": {\n    \"allow\": [\n      \"mcp__cluster__cluster_info\",\n      \"mcp__cluster__list_remote\",\n      \"mcp__cluster__check_queue\",\n      \"mcp__cluster__read_logs\",\n      \"mcp__cluster__search_logs\"\n    ]\n  }\n}\n```\n\nTools requiring permission (write/execute): `transfer_file`, `download_file`, `submit_job`, `poll_job`, `run_remote_command`, `singularity_test`\n\n## Prerequisites\n\n- SSH access to your cluster (key-based authentication)\n- SLURM scheduler (sbatch, squeue commands)\n\n## Guardrails\n\n- **Rate limiting** - max 30 commands per 5 min (configurable via env)\n- **Path validation** - all paths must be under REMOTE_BASE_PATH\n- **Dangerou…","publisher":{"name":"Florian Sp","url":null},"homepage":"https://github.com/FlorianSp2000/secure-cluster-mcp","repository":"https://github.com/FlorianSp2000/secure-cluster-mcp","version":"1.0.0","license":null,"protocols":["mcp"],"tags":["cluster","guardrails","hpc","mcp","slurm","ssh"],"pricing":null,"endpoints":[{"url":"pypi:secure-cluster-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":0.905,"provenance":"derived"},{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":0.802,"provenance":"derived"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"secure-cluster-mcp","registry":"pypi","observedAt":"2026-11-04T00:27:26.628Z","publishedAt":"2026-05-25T11:59:05.148612Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"secure-cluster-mcp","url":"https://pypi.org/project/secure-cluster-mcp/","firstSeenAt":"2026-09-10T12:21:17.565Z","fetchedAt":"2026-11-04T00:25:57.782Z","normalizedAt":"2026-11-04T00:25:57.782Z"}]},"firstSeenAt":"2026-09-10T12:21:17.565Z","updatedAt":"2026-11-04T00:27:26.628Z"}