Skip to main content
Glama
Timandes

MCP Gateway

by Timandes

Puerta de enlace MCP

La puerta de enlace MCP (Protocolo de Contexto de Modelo) puede traducir las llamadas a herramientas MCP a solicitudes API HTTP tradicionales. Ofrece una forma configurable de integrar la API HTTP existente en el entorno MCP.

Empezando

Crear archivo de configuración desde config.example.yaml :

$ cp config.example.yaml config.yaml

Edite el archivo config.yaml y asigne todas las API a las herramientas MCP.

Luego comience a ejecutarlo con el transporte SSE:

$ 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)

El valor predeterminado es 3001.

Related MCP server: Hello Service MCP Server

Control del servidor

Cambiar puerto

Proporcionar el parámetro --port=<port_no> en la línea de comando cambiará el puerto al transporte SSE.

Iniciar puerta de enlace con el puerto 3002:

$ 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)

Transporte de stdio

Proporcionar el parámetro --transport=stdio en la línea de comando cambiará el transporte a stdio.

P.EJ:

$ uv run mcp-gateway --transport=stdio

No tiene sentido iniciar la puerta de enlace manualmente en el transporte de stdio. Puedes configurarla en Cursor o Cline como:

{
    "mcpServers": {
        "mcp-gateway": {
          "command": "uv",
          "args": ["run", "mcp-gateway", "--transport=stdio"]
        }
      }
}

O Inspector MCP con valores de formulario:

Artículo

Valor

Tipo de transporte

STDIO

Dominio

ultravioleta

Argumentos

ejecutar mcp-gateway --transport=stdio

Archivo de configuración

Hay dos partes en la configuración YAML: server y tools . server define la información básica para el uso del servidor de enlace. tools definen la asignación de una sola herramienta MCP a una solicitud de API HTTP.

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 }}

Servidor

Artículo

Descripción

nombre

Nombre del servidor

configuración

Pares clave/valor a los que se puede hacer referencia mediante la variable {{.config.xxx}} en las plantillas

Herramientas

tools es una lista de asignaciones de herramientas MCP. Las propiedades de una sola herramienta se definen de la siguiente manera:

Artículo

Descripción

nombre

Nombre de la herramienta (nombre de la función), que se proporciona a LLM.

descripción

Descripción de la herramienta a través de la cual LLM puede comprender lo que la herramienta podría hacer.

argumentos

Argumentos de la herramienta (argumentos de la función).

Solicitud de plantilla

Solicitar mapeo a la API HTTP de destino.

Plantilla de respuesta

Mapeo de respuesta para la respuesta de la API HTTP de destino.

Las propiedades de argumento único se definen de la siguiente manera:

Artículo

Tipo

Descripción

nombre

Nombre del argumento, que se proporciona a LLM.

descripción

Descripción del argumento a través del cual LLM puede comprender y decidir qué valor debe ser llenado.

requerido

Booleano

Argumento requerido o no.

Las propiedades de la plantilla de solicitud se definen de la siguiente manera:

Artículo

Descripción

método

Método HTTP

URL

Plantilla de URL de API HTTP de destino

encabezados

encabezados HTTP

Los encabezados HTTP se definen de la siguiente manera:

Artículo

Descripción

llave

Clave de encabezado

valor

Plantilla de valor de encabezado

Las propiedades de la plantilla de respuesta se definen de la siguiente manera:

Artículo

Descripción

cuerpo

Plantilla de cuerpo de respuesta

Contribución

Todo tipo de contribuciones son bienvenidas.

Related MCP Connectors

  • The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.

  • Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server

  • MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows

  • The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
    8
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants to make HTTP requests (GET, POST, PUT, DELETE) to external APIs through standardized MCP tools.
    4
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A standalone proxy that transforms any OpenAPI or Swagger-described REST API into an MCP server by mapping API operations to executable MCP tools. It enables AI clients to interact with existing web services through automated HTTP requests based on their official documentation.
    15 npm
    16
    MIT