GPT MCP Proxy

A REST API server that provides HTTP access to Multiple Command Protocol (MCP) tools. This server acts as a bridge between HTTP clients and MCP-compliant tool servers, allowing tools to be discovered and executed via REST endpoints. This is very useful for integrating MCP tools with custom GPT through Actions.

Features

• List available MCP servers and their tools
• Get detailed information about specific tools
• Execute tools with custom parameters
• OpenAPI 3.1.0 specification
• Automatic public HTTPS exposure via ngrok

Prerequisites

• Go 1.20 or later
• ngrok account and authtoken
• MCP-compliant tools

Configuration

The server requires the following environment variables:

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

Configuration File Format

Create an mcp_settings.json file with your MCP server configurations:

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

API Endpoints

• GET /openapi.json - OpenAPI specification
• GET /mcp/servers - List all servers and their tools
• GET /mcp/{serverName} - Get server details
• GET /mcp/{serverName}/tools/{toolName} - Get tool details
• POST /mcp/{serverName}/tools/{toolName}/execute - Execute a tool

Usage

1. Set up environment variables
2. Prepare configuration file
3. Run the server:

go run main.go

Development

To build from source:

git clone https://github.com/wricardo/mcp-http-server.git
cd mcp-http-server
go build

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.