Setup guide
Proxima
Install Node.js 18+ before anything else. Linux (Ubuntu/Debian):sudo apt update && sudo apt install nodejs npm -y W indows: Download the LTS installer from nodejs.org and check "Add to PATH" during
Install Node.js 18+ before anything else.
macOS:brew install node
Linux (Ubuntu/Debian):sudo apt update && sudo apt install nodejs npm -y
Linux (Fedora):sudo dnf install nodejs npm -y
W indows: Download the LTS installer from nodejs.org and check "Add to PATH" during
install
Verify: node –version
npx -y proxima
git clone https://github.com/Zen4-bit/Proxima.git
cd Proxima
npm install
npm start
The server runs on localhost:19222.
Cong le path: ~/Library/Application Support/Claude/claude_desktop_confi g.json
Cong le path: ~/.confi g/Claude/claude_desktop_confi g.json
Proxim a Setup Guide
Prerequisites
Installation
M ethod 1: npx (Fastest)
M ethod 2: Clone from Source
Congure Claude Desktop
m acOS
Linux
Cong le path: %APPDATA%\Claude\claude_desktop_confi g.json
{ "mcpServers": { "proxima": { "command": "npx", "args": ["-y", "proxima"] } } } { "mcpServers": { "proxima": { "command": "node", "args": ["/full/path/to/Proxima/src/mcp-server-v3.js"] } } } On W indows, use forward slashes / or double backslashes \\ in the path. Go to Cursor Settings → MCP and paste the same JSON block above. sudo nano /etc/systemd/system/proxima.service [Unit]
Description=Proxima MCP Server
After=network.target [Service]
ExecStart=/usr/bin/node /home/YOUR_USERNAME/Proxima/src/mcp-server-v3.js
Restart=always User=YOUR_USERNAME W indows Cong (npx m ethod) Cong (source m ethod)
Congure Cursor
Run as Background Service (Optional)
Linux (system d)
[Install] WantedBy=multi-user.target sudo systemctl enable proxima sudo systemctl start proxima
npm install -g pm2
pm2 start "node C:/Users/YOUR_USERNAME/Proxima/src/mcp-server-v3.js" –name proxima
pm2 startup pm2 save . Restart Claude Desktop or Cursor after saving the cong . Allow access when prompted for localhost:19222 . Log in to each AI provider (ChatGPT, Claude, Gemini, Perplexity) in the embedded browser
- sessions are saved automatically
W indows (pm 2)
Final Steps
Final checklist
- The required app, command, or service opens correctly.
- Credentials are stored outside public files and screenshots.
- A small test run completes before you use the setup for real work.
- You know where logs, output files, and error messages are stored.