@ratio-mcp/setup

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.

Install

npx @ratio-mcp/setup

That's it. The script:

1. Resolves your local npx absolute path (Claude Desktop is a GUI app and doesn't inherit terminal PATH).
2. Writes the Claude Desktop config:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
3. Writes the Claude Code CLI config (~/.claude.json).
4. Installs the ratio-agent-builder skill into ~/.claude/skills/ (auto-loaded by Claude Code on the next session).

Existing configs are merged — your other MCP servers stay intact. A .bak backup is written alongside every modified file.

Production environment

This package points to:

| | | |---|---| | API URL | https://gkx.gokwik.co/aes | | Developer dashboard | https://dev-developers.dev.gokwik.in |

For other environments, install a different scoped variant:

npx @ratio-mcp-qa/setup       # QA env
npx @ratio-mcp/setup          # Production

Verify the install

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .mcpServers

Should show:

{
  "ratio-mcp-dev": {
    "command": "/usr/local/bin/npx",
    "args": ["-y", "@ratio-mcp/dev-server@latest"],
    "env": { "PATH": "..." }
  },
  "ratio-mcp-doc": {
    "command": "/usr/local/bin/npx",
    "args": ["-y", "@ratio-mcp/docs-server@latest"],
    "env": { "PATH": "..." }
  }
}

Restart Claude Desktop fully (Cmd+Q, then reopen), then ask: "I want to build a Ratio app."

Roll back

To restore the previous config:

mv ~/Library/Application\ Support/Claude/claude_desktop_config.json.bak \
   ~/Library/Application\ Support/Claude/claude_desktop_config.json
mv ~/.claude.json.bak ~/.claude.json
rm -rf ~/.claude/skills/ratio-agent-builder

Troubleshooting

| Symptom | Fix | |---|---| | Claude Desktop doesn't see the servers | Fully restart Desktop — Cmd+Q, then reopen | | command not found: npx inside Claude | Re-run npx @ratio-mcp/setup from a terminal — it auto-resolves the absolute npx path | | Stale skill content | rm -rf ~/.claude/skills/ratio-agent-builder && npx @ratio-mcp/setup | | Wrong env (e.g., calling sandbox or QA from production install) | Confirm the config shows @ratio-mcp/* in args |

License

UNLICENSED — internal to the Ratio platform / GoKwik.