Gpt MCP Proxy

🚀 GPT MCP Proxy Server

A REST API server that allows access to multiple Model Command Protocol (MCP) tools via HTTP. This server acts as a bridge between HTTP clients and MCP-compliant tool servers, enabling tool discovery and execution through REST endpoints.

This approach is highly useful for integrating MCP tools with custom GPT models through operations.

✨ Features

• List available MCP servers and their tools.
• Retrieve detailed information about specific tools.
• Execute tools with custom parameters.
• Adhere to the OpenAPI 3.1.0 specification.
• Provide automatic public HTTPS access via ngrok.

📦 Installation

Prerequisites

• Go 1.20 or higher.
• An ngrok account and authtoken.
• MCP-compliant tools.

Configuration

The server requires the following environment variables:

NGROK_AUTH_TOKEN=your_ngrook_authtoken
NGROK_DOMAIN=your_ngrook_domain
MCP_CONFIG_FILE=/path/to/mcp_settings.json  # Optional, default is mcp_settings.json

Configuration File Format

Create an mcp_settings.json file containing your MCP server configuration:

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

📚 Documentation

API Endpoints

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

💻 Usage Examples

Basic Usage

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

go run main.go

Development

Build from source code:

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

📄 License

This project is licensed under the MIT License.

🤝 Contribution

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