Proxima Documentation

Proxima is a local MCP (Model Context Protocol) server that connects multiple AI providers to your coding environment. Instead of paying for API keys, use your existing AI accounts directly.

Model Context Protocol (MCP) is an open standard that connects AI assistants with external tools and data sources.

Installation

Requirements

Windows 10 / 11
Node.js (Required for MCP server)

Option 1: Installer (Recommended)

Download the latest release and run the installer. This sets up everything automatically.

Download for Windows

Option 2: Run from Source

git clone https://github.com/Zen4-bit/Proxima.git cd proxima npm install npm start

Configuration

Add this to your AI coding app's MCP configuration (Cursor, VS Code, Cloud Desktop, etc.):

{ "mcpServers": { "proxima": { "command": "node", "args": ["C:/path/to/proxima/src/mcp-server-v3.js"] } } }

Tip: You can copy the exact configuration JSON from the "Settings" tab in the Proxima application.

Search Tools

Tools for retrieving information from the web.

Tool Name	Description
`deep_search`	Comprehensive web search for detailed topics.
`pro_search`	Advanced research query with multiple sources.
`youtube_search`	Find relevant YouTube videos and transcripts.
`reddit_search`	Search Reddit discussions and threads.
`news_search`	Get the latest news articles on a topic.
`academic_search`	Find scholarly papers and research.

Code Tools

Utilities for generating, debugging, and optimizing code.

Tool Name	Description
`verify_code`	Check code against best practices and linting rules.
`explain_code`	Get detailed explanations of complex code snippets.
`generate_code`	Generate boilerplate or specific function implementations.
`debug_code`	Identify bugs and suggest fixes.
`optimize_code`	Suggest performance improvements.
`review_code`	Comprehensive code review feedback.

Multi-AI Tools

Orchestrate multiple AI providers.

Tool Name	Description
`ask_chatgpt`	Directly query ChatGPT.
`ask_claude`	Directly query Claude.
`ask_gemini`	Directly query Gemini.
`ask_all_ais`	Query all providers simultaneously for consensus.
`compare_ais`	Compare responses from different models side-by-side.
`smart_query`	Automatically selects the best provider for the query.

Troubleshooting

Windows Firewall Prompt

Proxima runs a local server on localhost:19222. Click "Allow" if Windows Firewall prompts you. The server only accepts local connections.

Provider shows "Not logged in"

Click the provider tab in the Proxima app and complete the login process in the embedded browser. Your session cookies will be saved locally.

MCP Tools not appearing

Ensure Proxima is running in the background.
Verify the path in your unique mcp-config.json matches your installation path.
Restart your coding environment (VS Code, Cursor).

License

This software is for personal, non-commercial use only. Commercial and enterprise use is not permitted without a license.