GPT MCP Proxy Server

Provides HTTP access to MCP tools through a REST API for easy discovery and execution of MCP-enabled capabilities.

GitHub Stars

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wricardo-gpt-mcp-proxy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ],
      "env": {
        "NGROK_DOMAIN": "yourdomain.ngrok.io",
        "MCP_CONFIG_FILE": "/path/to/mcp_settings.json",
        "NGROK_AUTH_TOKEN": "你的_ngrok_auth_token"
      }
    }
  }
}

GPT MCP Proxy is a REST API server that bridges HTTP clients and MCP-compliant tool servers, enabling you to discover and run MCP tools through simple HTTP endpoints. It is useful for integrating MCP capabilities with GPT-based workflows and custom Actions.

How to use

You can use the MCP proxy to list available MCP servers and tools, view details about a specific tool, and execute tools with your chosen parameters. Start by starting the proxy, then query the exposed endpoints to discover MCP capabilities and run them from your client code or automation.

How to install

Prerequisites you need before installing the server are as follows.

Install Go 1.20 or later to build and run the proxy.

Create and configure environment variables for public exposure and MCP settings.

Prepare the MCP configuration file if you want to specify MCP servers and their command arguments.

Run the server from the source code. The final command starts the Go runtime and launches the proxy.

Configuration

Set the following environment variables to enable public HTTPS exposure and to point the proxy at your MCP configuration.

NGROK_AUTH_TOKEN=your_ngrok_auth_token
NGROK_DOMAIN=your_ngrok_domain
MCP_CONFIG_FILE=/path/to/mcp_settings.json  # Optional, defaults to mcp_settings.json

Create an mcp_settings.json file if you want to define MCP servers and the tools they expose. The file can specify one or more servers and how to run them. For example, to expose a filesystem MCP server via npx, you can use the following configuration.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Security and notes

When you enable public exposure via ngrok, manage access to the proxy carefully. Use secure tokens, restrict IP access where possible, and monitor usage to prevent abuse.

Available tools

list_servers

List available MCP servers and their tools

server_info

Get detailed information about a specific MCP server

tool_info

Get detailed information about a specific tool on a server

execute_tool

Execute a tool with given parameters

Built by

VeilStrat

AI signals for GTM teams