mcpproxy-go MCP工具

1. Install

macOS (Recommended - DMG Installer):

Download the latest DMG installer for your architecture: - Apple Silicon (M1/M2): Download DMG → mcpproxy-*-darwin-arm64.dmg - Intel Mac: Download DMG → mcpproxy-*-darwin-amd64.dmg

Windows (Recommended - Installer):

Download the latest Windows installer for your architecture: - x64 (64-bit): Download Installer → mcpproxy-setup-*-amd64.exe - ARM64: Download Installer → mcpproxy-setup-*-arm64.exe

The installer automatically: - Installs both mcpproxy.exe (core server) and mcpproxy-tray.exe (system tray app) to Program Files - Adds MCPProxy to your system PATH for command-line access - Creates Start Menu shortcuts - Supports silent installation: .\mcpproxy-setup.exe /VERYSILENT

Alternative install methods:

macOS (Homebrew): ```bash

One-click install into Cursor IDE

Manual install

1. Open Cursor Settings 2. Click "Tools & Integrations" 3. Add MCP server

    "MCPProxy": {
      "type": "http",
      "url": "http://localhost:8080/mcp/"
    }

---

🔐 Optional HTTPS Setup

MCPProxy works with HTTP by default for easy setup. HTTPS is optional and primarily useful for production environments or when stricter security is required.

💡 Note: Most users can stick with HTTP (the default) as it works perfectly with all supported clients including Claude Desktop, Cursor, and VS Code.

Quick HTTPS Setup

1. Enable HTTPS (choose one method): ```bash

Getting Started

• Installation
• Quick Start

Development Setup

make dev-setup                # Install swag, frontend deps, Playwright
brew install prek             # Install pre-commit hook runner (or: uv tool install prek)
prek install                  # Install pre-commit hooks
prek install --hook-type pre-push  # Install pre-push hooks

Build & Test

make build          # Build frontend + backend
make swagger        # Regenerate OpenAPI spec
make test           # Unit tests
make test-e2e       # E2E tests
make lint           # Run linters

Quick Start

Method 1: Environment variable

export MCPPROXY_TLS_ENABLED=true mcpproxy serve

Method 2: Config file

Edit ~/.mcpproxy/mcp_config.json and set "tls.enabled": true

**2. Trust the certificate** (one-time setup):

3. Use HTTPS URLs: - MCP endpoint: https://localhost:8080/mcp - Web UI: https://localhost:8080/ui/

Configuration

• Config File Reference
• Upstream Servers
• Environment Variables

macOS / Linux — headless CLI only:

brew install smart-mcp-proxy/mcpproxy/mcpproxy

The cask installs the menu-bar app (bundles the CLI); the formula is the CLI binary only. Both update via `brew upgrade`.

Linux (Debian/Ubuntu) — apt repository, auto-updates via `apt upgrade`:

Linux (Fedora / RHEL / Rocky / AlmaLinux) — dnf repository, auto-updates via `dnf upgrade`:

CLI Reference

• Command Reference
• Management Commands
• Activity Commands
• Security Commands

API

• REST API
• MCP Protocol

---

Claude Desktop Integration

For Claude Desktop, add this to your claude_desktop_config.json:

HTTP (Default - Recommended):

{
  "mcpServers": {
    "mcpproxy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8080/mcp"
      ]
    }
  }
}

HTTPS (With Certificate Trust):

{
  "mcpServers": {
    "mcpproxy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://localhost:8080/mcp"
      ],
      "env": {
        "NODE_EXTRA_CA_CERTS": "~/.mcpproxy/certs/ca.pem"
      }
    }
  }
}

Troubleshooting HTTPS

Certificate trust issues: ```bash