Postman MCP Generator

Proporciona herramientas de JavaScript para realizar solicitudes de API, generadas por el Postman MCP Generator.

GitHubPrueba este MCPPatrocinado

Documentación

Postman MCP Generator

¡Bienvenido a tu servidor MCP generado! 🚀 Este proyecto fue creado con el Postman MCP Generator, configurado en modo de salida de servidor Model Context Provider (MCP). Te proporciona:

  • ✅ Un servidor compatible con MCP (mcpServer.js)
  • ✅ Herramientas JavaScript generadas automáticamente para cada solicitud de API de Postman seleccionada

¡Vamos a configurarlo!

🚦 Primeros Pasos

⚙️ Requisitos Previos

Antes de comenzar, asegúrate de tener:

Advertencia: si ejecutas con una versión inferior de Node, fetch no estará presente. Las herramientas usan fetch para realizar llamadas HTTP. Para solucionar esto, puedes modificar las herramientas para usar node-fetch en su lugar. Asegúrate de que node-fetch esté instalado como dependencia y luego impórtalo como fetch en cada archivo de herramienta.

📥 Instalación y Configuración

1. Instalar dependencias

Ejecuta desde el directorio raíz de tu proyecto:

npm install

🔐 Configurar variables de entorno de las herramientas

En el archivo .env, verás marcadores de posición de variables de entorno, uno por cada espacio de trabajo del que provienen las herramientas seleccionadas. Por ejemplo, si seleccionaste solicitudes de 2 espacios de trabajo, p. ej. Acme y Widgets, verás dos marcadores de posición:

ACME_API_KEY=
WIDGETS_API_KEY=

Actualiza los valores con las claves de API reales para cada API. Estas variables de entorno se utilizan dentro de las herramientas generadas para establecer la clave de API para cada solicitud. Puedes inspeccionar un archivo en el directorio tools para ver cómo funciona.

// environment variables are used inside of each tool file
const apiKey = process.env.ACME_API_KEY;

Advertencia: Esto puede no ser correcto para todas las APIs. La lógica de generación es relativamente simple: para cada espacio de trabajo, creamos una variable de entorno con el mismo nombre que el slug del espacio de trabajo, y luego usamos esa variable de entorno en cada archivo de herramienta que pertenece a ese espacio de trabajo. Si este no es el comportamiento correcto para tu API elegida, ¡no hay problema! Puedes actualizar manualmente cualquier cosa en el archivo .env o en los archivos de herramienta para reflejar con precisión el método de autenticación de la API.

🌐 Prueba el Servidor MCP con Postman

El Servidor MCP (mcpServer.js) expone tus herramientas de API automatizadas a clientes compatibles con MCP, como Claude Desktop o la Aplicación de Escritorio de Postman. Recomendamos que pruebes el servidor con Postman primero y luego continúes usándolo con un LLM.

La Aplicación de Escritorio de Postman es la forma más fácil de ejecutar y probar servidores MCP. Probar el servidor descargado primero es opcional pero recomendado.

Paso 1: Descarga la última versión de la Aplicación de Escritorio de Postman desde https://www.postman.com/downloads/.

Paso 2: Lee el artículo de documentación aquí y mira cómo crear una solicitud MCP dentro de la aplicación de Postman.

Paso 3: Configura el tipo de solicitud MCP como STDIO y establece el comando como node </absolute/path/to/mcpServer.js>. Si tienes problemas al usar solo node (p. ej. se usa una versión antigua), proporciona una ruta absoluta a una versión de node 18+. Puedes obtener la ruta completa a node ejecutando:

which node

Para verificar la versión de node, ejecuta:

node --version

Para obtener la ruta absoluta a mcpServer.js, ejecuta:

realpath mcpServer.js

Usa el comando node seguido de la ruta completa a mcpServer.js como comando para tu nueva Solicitud MCP de Postman. Luego haz clic en el botón Conectar. Deberías ver una lista de herramientas que seleccionaste antes de generar el servidor. Puedes probar que cada herramienta funcione aquí antes de conectar el servidor MCP a un LLM.

👩‍💻 Conecta el Servidor MCP a Claude

Puedes conectar tu servidor MCP a cualquier cliente MCP. Aquí proporcionamos instrucciones para conectarlo a Claude Desktop.

Paso 1: Anota la ruta completa a node y al mcpServer.js del paso anterior.

Paso 2: Abre Claude Desktop → Configuración → Desarrolladores → Editar Configuración y agrega un nuevo servidor MCP:

{
  "mcpServers": {
    "<server_name>": {
      "command": "<absolute/path/to/node>",
      "args": ["<absolute/path/to/mcpServer.js>"]
    }
  }
}

Reinicia Claude Desktop para activar este cambio. Asegúrate de que el nuevo MCP esté activado y tenga un círculo verde junto a él. Si es así, estás listo para comenzar una sesión de chat que pueda usar las herramientas que has conectado.

Advertencia: Si no proporcionas una ruta absoluta a una versión de node que sea v18+, Claude (y otros clientes MCP) puede recurrir a otra versión de node en el sistema de una versión anterior. En este caso, la API de fetch no estará presente y las llamadas a herramientas no funcionarán. Si eso sucede, puedes a) instalar una versión más nueva de node y apuntar a ella en el comando, o b) importar node-fetch en cada herramienta como fetch, asegurándote de agregar también la dependencia node-fetch a tu package.json.

Opciones Adicionales

🐳 Despliegue con Docker (Producción)

Para despliegues de producción, puedes usar Docker:

1. Construir imagen Docker

docker build -t <your_server_name> .

2. Integración con Claude Desktop

Agrega la configuración del servidor Docker a Claude Desktop (Configuración → Desarrolladores → Editar Configuración):

{
  "mcpServers": {
    "<your_server_name>": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file=.env", "<your_server_name>"]
    }
  }
}

Agrega tus variables de entorno (claves de API, etc.) dentro del archivo .env.

El proyecto incluye la siguiente configuración mínima de Docker:

FROM node:22.12-alpine AS builder

WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install

COPY . .

ENTRYPOINT ["node", "mcpServer.js"]

🌐 Eventos Enviados por el Servidor (SSE)

Para ejecutar el servidor con soporte de Eventos Enviados por el Servidor (SSE), usa el indicador --sse:

node mcpServer.js --sse

🛠️ Comandos CLI Adicionales

Listar herramientas

Lista descripciones y parámetros de todas las herramientas generadas con:

node index.js tools

Ejemplo:

Available Tools:

Workspace: acme-workspace
  Collection: useful-api
    list_all_customers
      Description: Retrieve a list of useful things.
      Parameters:
        - magic: The required magic power
        - limit: Number of results returned
        [...additional parameters...]

➕ Agregar Nuevas Herramientas

Extiende tu servidor MCP con más herramientas fácilmente:

  1. Visita Postman MCP Generator.
  2. Elige nuevas solicitudes de API, genera un nuevo servidor MCP y descárgalo.
  3. Copia las nuevas herramientas generadas en la carpeta tools/ de tu proyecto existente.
  4. Actualiza tu archivo tools/paths.js para incluir las referencias de las nuevas herramientas.

💬 Preguntas y Soporte

Visita la página de Postman MCP Generator para actualizaciones y nuevas capacidades.

Únete al canal #mcp-lab en el Discord de Postman para compartir lo que has construido y obtener ayuda.