Servidor MCP de generación de herramientas Postman

Un servidor MCP que genera herramientas de agente de IA a partir de colecciones y solicitudes de Postman. Este servidor se integra con la API de Postman para convertir los puntos finales de la API en código con seguridad de tipos compatible con diversos frameworks de IA.

El Protocolo de Contexto de Modelo (MCP) es un nuevo protocolo estandarizado para gestionar el contexto entre grandes modelos de lenguaje (LLM) y sistemas externos. En este repositorio, proporcionamos un instalador y un servidor MCP para la API de generación de herramientas Postman .

Esto le permite usar Claude Desktop , o cualquier cliente MCP como Cline , para usar lenguaje natural para lograr cosas en su cuenta de Postman, por ejemplo:

• Create an AI tool for: collectionID: 12345-abcde requestID: 67890-fghij typescript openai

Características

• Generar código TypeScript/JavaScript a partir de colecciones de Postman

• Compatibilidad con múltiples marcos de IA (OpenAI, Mistral, Gemini, Anthropic, LangChain, AutoGen)

• Generación de código con seguridad de tipos

• Manejo de errores y validación de respuestas

Related MCP server: Postman MCP Generator

Manifestación

Configuración

1. Instalar dependencias:

npm install

2. Construir el servidor:

npm run build

3. Configure los ajustes de MCP agregando lo siguiente a su archivo de configuración de Claude ( cline_mcp_settings.json ):

{
  "mcpServers": {
    "postman-ai-tools": {
      "command": "node",
      "args": [
        "/path/to/postman-tool-generation-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso

El servidor proporciona una única herramienta llamada generate_ai_tool con los siguientes parámetros:

{
  collectionId: string;    // The Public API Network collection ID
  requestId: string;       // The public request ID
  language: "javascript" | "typescript";  // Programming language to use
  agentFramework: "openai" | "mistral" | "gemini" | "anthropic" | "langchain" | "autogen";  // AI framework
}

Ejemplo

// Using the tool through MCP
const result = await use_mcp_tool({
  server_name: "postman-ai-tools",
  tool_name: "generate_ai_tool",
  arguments: {
    collectionId: "your-collection-id",
    requestId: "your-request-id",
    language: "typescript",
    agentFramework: "openai"
  }
});

Código generado

La herramienta genera código seguro que incluye:

• Definiciones de tipos para solicitud/respuesta

• Manejo de errores

• Integración de API

• Definiciones de funciones de OpenAI

• Documentación y ejemplos

Desarrollo

1. Instalar dependencias:

npm install

2. Realizar cambios en src/index.ts

3. Construir el servidor:

npm run build

4. Reinicie la aplicación Claude para cargar el servidor actualizado

Variables de entorno

• POSTMAN_API_KEY : Su clave API de Postman (obligatoria)

Manejo de errores

El servidor incluye un manejo integral de errores para:

• Parámetros no válidos

• Fallos de API

• Errores de análisis de JSON

• Problemas de red

Las respuestas de error incluyen mensajes detallados para ayudar a diagnosticar problemas.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Licencia MIT