openrouter-mcp-bridge

# Open Bridge  A lightweight MCP (Model Context Protocol) server that enables AI coding assistants to interact with OpenRouter API. Works with Claude Code, Cursor, VS Code, and other MCP-compatible clients. ## ✨ Features - **Direct OpenRouter API Integration**: Async HTTP calls using httpx - **Simple MCP Tools**: Three core functions for queries, file analysis, and batch processing - **Stateless Operation**: No sessions, caching, or complex state management - **Production Ready**: Robust error handling with configurable timeouts (default: 90 seconds) - **Minimal Dependencies**: httpx, python-dotenv, and mcp>=1.0.0 - **Async/Await**: Full async support for concurrent operations - **Model Flexibility**: Support any OpenRouter-compatible model ## 🚀 Quick Start ### Prerequisites 1. **Get OpenRouter API Key**: ```bash # Visit https://openrouter.ai/keys # Sign up and get your API key ``` 2. **Set Environment Variable**: ```bash export OPENROUTER_API_KEY="your-api-key-here" ``` ### Installation **Local Development:** ```bash # Create virtual environment python3 -m venv .venv source .venv/bin/activate # Install dependencies pip install -e . # Run directly python -m src ``` **Using uvx (from local directory):** ```bash uvx --from /path/to/open-bridge open-bridge ``` ## ⚙️ Configuration ### Environment Variables | Variable | Required | Default | Description | |----------|----------|---------|-------------| | `OPENROUTER_API_KEY` | ✅ Yes | - | Your OpenRouter API key | | `OPENROUTER_MODEL` | No | `openai/gpt-4o` | Model to use | | `OPENROUTER_TIMEOUT` | No | `90` | Request timeout (seconds) | ### Example Configuration (Claude Code) ```bash # Add to Claude Code with local installation claude mcp add open-bridge -s user \ --env OPENROUTER_API_KEY=sk-or-... \ --env OPENROUTER_MODEL=anthropic/claude-3.5-sonnet \ -- python -m $(pwd)/src ``` ## 🛠️ Available Tools …