Overview
mcp-remote-static is a remote proxy tool for Model Context Protocol (MCP) with static OAuth client configuration support, designed for marketplace scenarios and OAuth servers that require pre-registered clients. This release provides complete support for static OAuth 2.0 authorization code flow.
Key Features
- Static OAuth Client Support: Supports pre-registered
client_idandclient_secretconfiguration - Multi-Client Compatibility: Compatible with MCP clients including Claude Desktop, Cursor, and Windsurf
- Flexible Configuration: Supports three configuration methods: JSON string, environment variables, and file paths
- Multiple Transport Strategies: Supports SSE-only, HTTP-only, SSE-first, and HTTP-first transport modes
- Debug Support: Provides detailed debug logging capabilities
Configuration Requirements
- Marketplace Callback URL: Must register
http://localhost:17091/oauth/callbackin OAuth client settings - Node.js Version: Requires Node.js 18 or higher
Usage
Use directly via npx:
npx mcp-remote-static <server-url> --static-oauth-client-info <client-info>
Or configure through MCP client configuration files (see README.md for details)
Technical Features
- Built on
@modelcontextprotocol/sdk - Supports standard OAuth 2.0 authorization code flow
- Automatic token refresh and credential management
- Supports custom HTTP request headers
- Supports tool filtering and authentication timeout configuration
Documentation
For complete configuration instructions and usage guide, please refer to the project README.md