Advertise
MCP.so
Sign In
M

MCP Gateway

@Timandes

Repository

Basic information

Category

Other

Transports

stdio

Author

Timandes

Submitted by

Timandes White

About MCP Gateway

No overview available yet

#mcp-gateway#http-api#gateway

MCP Gateway config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-gateway-timandes": {
      "command": "uv",
      "args": [
        "run",
        "mcp-gateway"
      ]
    }
  }
}

MCP Gateway tools

14

Tool name (Function name), which is provided to LLM.

Tool description through which LLM can understand what the tool could do.

Arguments of tool (Function arguments).

Request mapping to target HTTP API.

Response mapping for response of target HTTP API.

Boolean

HTTP method

Target HTTP API url template

HTTP headers

Header key

Header value template

Response body template

Overview

What is MCP Gateway?

MCP Gateway is a server that translates Model Context Protocol (MCP) tool callings into traditional HTTP API requests, providing a configurable bridge to expose existing HTTP APIs through MCP.

How to use MCP Gateway?

Copy the example config file (config.example.yaml) to config.yaml, then edit it to map HTTP APIs to MCP tools. Launch the server with SSE transport using uv run mcp-gateway (default port 3001). For stdio transport, use --transport=stdio and configure it in Cursor, Cline, or MCP Inspector with command uv run mcp-gateway --transport=stdio.

Key features of MCP Gateway

  • Translates MCP tool calls to HTTP API requests
  • Configurable via YAML mapping file
  • Supports SSE and stdio transport modes
  • Allows dynamic config references with {{.config.xxx}} templates
  • Customizable request and response templates
  • Easily changeable server port via --port parameter

Use cases of MCP Gateway

  • Expose legacy REST APIs to AI agents using MCP
  • Create MCP tools from any HTTP API without writing code
  • Integrate existing web services into LLM-driven workflows
  • Bridge internal microservices with MCP-compatible clients

Frequently asked questions

1

What runtime or dependencies are required?

MCP Gateway runs via `uv`, requiring Python and the `uv` package manager to execute `uv run mcp-gateway`.

2

What transport protocols does MCP Gateway support?

The server supports SSE (default, on port 3001) and stdio transport, selectable with the `--transport` parameter.

3

How do I define a tool-to-API mapping?

Edit the `tools` section of `config.yaml` with tool name, description, arguments, a request template (URL, method, headers), and a response template for the HTTP API response.

4

Where does configuration data live?

All configuration is stored in a local YAML file (`config.yaml`) that you create from `config.example.yaml`. No external database is used.

5

Can I reference secrets or dynamic values in requests?

Yes, use Go‑template expressions like `{{.config.apiKey}}` and `{{.args.address}}` in the request template URL and headers. Static config values are defined under `server.config`.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Advertise