MCP Gateway
About
A gateway to translate MCP tool calls into HTTP API requests, configurable via YAML.
Details
- Author
- timandes
- Categories
- Developer Tools, API, Automation
Jump to
Setup
Install MCP Gateway in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/timandes/mcp-gateway
Follow the installation instructions in the repository README, then restart your MCP client.
MCP (Model Context Protocol) Gateway can translate MCP tool callings to traditional HTTP API requests. It can provide a configurable way to get existing HTTP API to MCP territory.
Create config file fromconfig.example.yaml:
Editconfig.yamlfile, map all APIs to MCP tools.
Then start launch it with SSE transport:
$ uv run mcp-gateway INFO: Started server process [15400] INFO: Waiting for application startup. INFO: Application startup complete. INFO: Uvicorn running on http://0.0.0.0:3001 (Press CTRL+C to quit)
Provide parameter--port=<port_no>in command line will change the port to SSE transport.
$ uv run mcp-gateway --port=3002 INFO: Started server process [15400] INFO: Waiting for application startup. INFO: Application startup complete. INFO: Uvicorn running on http://0.0.0.0:3002 (Press CTRL+C to quit)
Provide parameter--transport=stdioin command line will change the transport to stdio.
It's meaningless tomanuallylaunch gateway in stdio transport. You can configure in Cursor or Cline like:
{ "mcpServers": { "mcp-gateway": { "command": "uv", "args": ["run", "mcp-gateway", "--transport=stdio"] } } }
There is two parts in configuration YAML,serverandtools.serverdefines the basic info for gateway server use.toolsdefines the mapping from single MCP tool to HTTP API request.
server: name: rest-amap-server config: apiKey: foo tools: - name: maps-geo description: "将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标" args: - name: address description: "待解析的结构化地址信息" required: true - name: city description: "指定查询的城市" required: false requestTemplate: url: "https://restapi.amap.com/v3/geocode/geo?key={{.config.apiKey}}&address={{.args.address}}&city={{.args.city}}&source=ts_mcp" method: GET headers: - key: x-api-key value: "{{.config.apiKey}}" - key: Content-Type value: application/json responseTemplate: body: | # 地理编码信息 {{- range $index, $geo := .Geocodes }} ## 地点 {{add $index 1}} - 国家: {{ $geo.Country }} - 省份: {{ $geo.Province }} - 城市: {{ $geo.City }} - 城市代码: {{ $geo.Citycode }} - 区/县: {{ $geo.District }} - 街道: {{ $geo.Street }} - 门牌号: {{ $geo.Number }} - 行政编码: {{ $geo.Adcode }} - 坐标: {{ $geo.Location }} - 级别: {{ $geo.Level }} {{- end }}
toolsis list of MCP tools mapping. Single tool props. are defined as follows:
Single argument props. are defined as follows:
Request template props. are defined as follows:
Response template props are defined as follows:
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.
One remote MCP server for 500+ production APIs — Stripe, HubSpot, Postgres, Gmail, and more. OAuth and API key auth, credential management, and a CLI.
Single tool to control all 100+ API integrations, and UI components
Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.
Self-hosted MCP gateway: convert REST/SOAP/GraphQL/SQL APIs into MCP tools with 29 pre-built adapters, OAuth2, RBAC and audit log.
A universal bridge to convert any web API into an MCP server, supporting multiple transport types.
Dynamically creates MCP servers from web API configurations, integrating any REST API, GraphQL endpoint, or web service into MCP-compatible tools.
Hosted MCP server and coordination layer for AI coding agents — live API contracts, database schema, frontend/backend mismatch detection, and shared handoff tickets for Claude Code, Cursor, Codex, and Lovable.
An MCP server that dynamically loads tools from an external JSON file configured via an environment variable.
A lightweight server exposing Axone's capabilities through the Model-Context Protocol.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


