cloudgpu-mcp 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -0
- package/package.json +1 -1
- package/rules/cloudgpu.md +1 -1
- package/src/index.js +3 -3
package/README.md
CHANGED
|
@@ -92,6 +92,28 @@ extensions:
|
|
|
92
92
|
|
|
93
93
|
To check the install, ask your agent: "List the GPUs available, then estimate the cost for a 24 GB GPU for one hour. Do not create anything." You should see `list_gpus` and `estimate_cost` calls and a quote, and nothing is rented.
|
|
94
94
|
|
|
95
|
+
## Agent Skill
|
|
96
|
+
|
|
97
|
+
The same guidance is available as two [Agent Skills](https://agentskills.io):
|
|
98
|
+
|
|
99
|
+
- [`skills/cloudgpu/SKILL.md`](skills/cloudgpu/SKILL.md): renting and using a GPU. Claude Code loads it on demand when you ask for a GPU job. It expects the `cloudgpu` MCP tools to be installed (see above).
|
|
100
|
+
- [`skills/cloudgpu-model-api/SKILL.md`](skills/cloudgpu-model-api/SKILL.md): calling the OpenAI-compatible model API at `https://cloudgpu.app/v1` without renting a GPU. It works with the MCP tools or with just a `CLOUDGPU_API_KEY`.
|
|
101
|
+
|
|
102
|
+
- **Claude plugin:** both skills are included automatically when you install the CloudGPU Claude plugin from this repo's marketplace:
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
/plugin marketplace add mrhy7176/cloudgpu-mcp
|
|
106
|
+
/plugin install cloudgpu@cloudgpu
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
- **Claude Code, personal install:** copy `skills/cloudgpu/` and `skills/cloudgpu-model-api/` to `~/.claude/skills/`.
|
|
110
|
+
- **Claude Code, project install:** copy `skills/cloudgpu/` and `skills/cloudgpu-model-api/` to `.claude/skills/` in your project.
|
|
111
|
+
- **Cursor, Codex, Cline, Amp and other agents that read Agent Skills:** install both skills with the [skills CLI](https://skills.sh):
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
npx skills add mrhy7176/cloudgpu-mcp
|
|
115
|
+
```
|
|
116
|
+
|
|
95
117
|
## Tools
|
|
96
118
|
|
|
97
119
|
| Tool | What it does |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cloudgpu-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"mcpName": "io.github.mrhy7176/cloudgpu-mcp",
|
|
5
5
|
"description": "MCP server for cloudgpu.app: let Claude Code, Cursor, Cline, opencode, goose and other MCP clients rent a GPU per minute, run a job, fetch the results and shut it down, with spending limits the platform enforces.",
|
|
6
6
|
"type": "module",
|
package/rules/cloudgpu.md
CHANGED
|
@@ -19,7 +19,7 @@ Copy this file into your project as `AGENTS.md`, `.cursor/rules/cloudgpu.md` or
|
|
|
19
19
|
|
|
20
20
|
- Always set `max_spend_usd` and `max_hours`. CloudGPU's servers destroy the instance when either is reached, even if you have disconnected.
|
|
21
21
|
- Keep `idle_minutes` on (default 60). Raise it if setup will take long, because installing packages and downloading models leave the GPU idle.
|
|
22
|
-
-
|
|
22
|
+
- Call `get_status` at intervals, not in a tight loop, until the instance is `running`.
|
|
23
23
|
- `failed` instances are not charged. Tell the user, then offer another GPU.
|
|
24
24
|
|
|
25
25
|
## Working on the instance
|
package/src/index.js
CHANGED
|
@@ -27,7 +27,7 @@ import {
|
|
|
27
27
|
shq,
|
|
28
28
|
} from "./guards.js";
|
|
29
29
|
|
|
30
|
-
const VERSION = "0.1.
|
|
30
|
+
const VERSION = "0.1.2";
|
|
31
31
|
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
|
32
32
|
const RULES = fs.readFileSync(path.join(HERE, "..", "rules", "cloudgpu.md"), "utf8");
|
|
33
33
|
|
|
@@ -297,7 +297,7 @@ if (!cfg.readOnly) {
|
|
|
297
297
|
.default(60)
|
|
298
298
|
.describe("Destroy after the GPU has been idle this long; 0 turns it off; otherwise at least 10"),
|
|
299
299
|
},
|
|
300
|
-
annotations: { readOnlyHint: false, destructiveHint:
|
|
300
|
+
annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
|
|
301
301
|
},
|
|
302
302
|
wrap(async ({ quote_id, user_confirmed, max_spend_usd, max_hours, idle_minutes = 60 }) => {
|
|
303
303
|
if (user_confirmed !== true) {
|
|
@@ -334,7 +334,7 @@ if (!cfg.readOnly) {
|
|
|
334
334
|
track(inst.id);
|
|
335
335
|
return ok({
|
|
336
336
|
...publicInstance(inst),
|
|
337
|
-
next: "
|
|
337
|
+
next: "Call get_status at intervals (not in a tight loop) until status is running, then upload and run_command.",
|
|
338
338
|
});
|
|
339
339
|
}),
|
|
340
340
|
);
|