@ratio-mcp/setup 1.5.0 → 1.6.0
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 +98 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# @ratio-mcp/setup
|
|
2
|
+
|
|
3
|
+
> One-command installer for the Ratio MCP production servers. Registers `ratio-mcp-dev` and `ratio-mcp-doc` in Claude Desktop, Claude Code CLI, and Cursor.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx @ratio-mcp/setup
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
That's it. The script:
|
|
14
|
+
|
|
15
|
+
1. Resolves your local `npx` absolute path (Claude Desktop is a GUI app and doesn't inherit terminal `PATH`).
|
|
16
|
+
2. Writes the Claude Desktop config:
|
|
17
|
+
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
18
|
+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
19
|
+
- Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
20
|
+
3. Writes the Claude Code CLI config (`~/.claude.json`).
|
|
21
|
+
4. Installs the `ratio-agent-builder` skill into `~/.claude/skills/` (auto-loaded by Claude Code on the next session).
|
|
22
|
+
|
|
23
|
+
Existing configs are merged — your other MCP servers stay intact. A `.bak` backup is written alongside every modified file.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Production environment
|
|
28
|
+
|
|
29
|
+
This package points to:
|
|
30
|
+
|
|
31
|
+
| | |
|
|
32
|
+
|---|---|
|
|
33
|
+
| **API URL** | `https://gkx.gokwik.co/aes` |
|
|
34
|
+
| **Developer dashboard** | `https://dev-developers.dev.gokwik.in` |
|
|
35
|
+
|
|
36
|
+
For other environments, install a different scoped variant:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
npx @ratio-mcp-qa/setup # QA env
|
|
40
|
+
npx @ratio-mcp/setup # Production
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Verify the install
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .mcpServers
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Should show:
|
|
52
|
+
|
|
53
|
+
```jsonc
|
|
54
|
+
{
|
|
55
|
+
"ratio-mcp-dev": {
|
|
56
|
+
"command": "/usr/local/bin/npx",
|
|
57
|
+
"args": ["-y", "@ratio-mcp/dev-server@latest"],
|
|
58
|
+
"env": { "PATH": "..." }
|
|
59
|
+
},
|
|
60
|
+
"ratio-mcp-doc": {
|
|
61
|
+
"command": "/usr/local/bin/npx",
|
|
62
|
+
"args": ["-y", "@ratio-mcp/docs-server@latest"],
|
|
63
|
+
"env": { "PATH": "..." }
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Restart Claude Desktop fully (Cmd+Q, then reopen), then ask: *"I want to build a Ratio app."*
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Roll back
|
|
73
|
+
|
|
74
|
+
To restore the previous config:
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
mv ~/Library/Application\ Support/Claude/claude_desktop_config.json.bak \
|
|
78
|
+
~/Library/Application\ Support/Claude/claude_desktop_config.json
|
|
79
|
+
mv ~/.claude.json.bak ~/.claude.json
|
|
80
|
+
rm -rf ~/.claude/skills/ratio-agent-builder
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Troubleshooting
|
|
86
|
+
|
|
87
|
+
| Symptom | Fix |
|
|
88
|
+
|---|---|
|
|
89
|
+
| Claude Desktop doesn't see the servers | Fully restart Desktop — Cmd+Q, then reopen |
|
|
90
|
+
| `command not found: npx` inside Claude | Re-run `npx @ratio-mcp/setup` from a terminal — it auto-resolves the absolute `npx` path |
|
|
91
|
+
| Stale skill content | `rm -rf ~/.claude/skills/ratio-agent-builder && npx @ratio-mcp/setup` |
|
|
92
|
+
| Wrong env (e.g., calling sandbox or QA from production install) | Confirm the config shows `@ratio-mcp/*` in `args` |
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## License
|
|
97
|
+
|
|
98
|
+
UNLICENSED — internal to the Ratio platform / GoKwik.
|