RunPod Plugin for Claude Cowork

Manage your RunPod GPU infrastructure directly from Claude Cowork — pods, serverless jobs, and spend monitoring.

Installation

1. Cloner le repo

git clone https://github.com/Angelus174/runpod-cowork-plugin.git
cd runpod-cowork-plugin

2. Prérequis

• Node.js v18+ installé sur votre machine
• Une clé API RunPod : runpod.io/console/user/settings → API Keys

3. Configurer la clé API

Linux / macOS :

export RUNPOD_API_KEY=your_api_key_here

Pour la rendre permanente, ajoutez-la à votre ~/.zshrc ou ~/.bashrc.

Windows (PowerShell) :

$env:RUNPOD_API_KEY="your_api_key_here"

Pour la rendre permanente : Paramètres système → Variables d'environnement → Nouvelle variable utilisateur.

4. Installer dans Cowork

Dans Claude Cowork : Settings → Plugins → Install from folder → sélectionner ce dossier.

---

Ce que ça fait

Parlez naturellement à Claude :

"Liste mes pods et dis-moi combien ça me coûte" "Crée un pod GPU avec PyTorch si une machine compatible est disponible" "Lance un job sur mon endpoint de génération d'images" "Quel est mon solde de crédits ?"

Skills

Skill	Déclencheurs
runpod-pods	"list my pods", "create a pod", "stop/terminate pod", "available GPUs"
runpod-jobs	"run a job", "check job status", "cancel job", "endpoint health"
runpod-monitor	"my RunPod spend", "credit balance", "how much am I spending"

Outils MCP (13 au total)

Outil	Description
list_pods	Tous vos pods avec statut et coût
get_pod	Détail et métriques live d'un pod
create_pod	Déployer un nouveau pod GPU
stop_pod	Arrêter un pod (conserve le volume)
resume_pod	Relancer un pod stoppé
terminate_pod	Supprimer définitivement un pod
list_gpu_types	Catalogue GPU avec prix
run_serverless_job	Soumettre un job à un endpoint
get_job_status	Statut et output d'un job
cancel_job	Annuler un job
get_endpoint_health	Santé d'un endpoint serverless
list_endpoints	Tous vos endpoints serverless
get_spend	Solde et répartition des dépenses

Architecture

Claude Cowork
     │
     ▼
runpod-mcp.js  (process Node.js local, stdio)
     │
     ▼ HTTPS + Bearer token
api.runpod.io  (GraphQL + REST v2)

Le serveur MCP tourne localement — vos données transitent directement de votre machine vers RunPod, sans serveur tiers.

Sécurité

• Clé API transmise via Authorization: Bearer header uniquement (jamais en URL)
• Validation stricte des IDs pour prévenir les injections
• Mot de passe Jupyter obligatoire et paramétrable (min 8 chars)
• Erreurs API loggées en interne, non exposées au client

⚠️ Note : Do not pass secrets in the env parameter of create_pod unless you trust the Docker image and the pod environment. The plugin automatically blocks variables matching SECRET, PASSWORD, API_KEY, TOKEN, PRIVATE_KEY, or CREDENTIALS.

Licence

MIT — ASSINOV Global FZCO, 2026