Postman MCP Server

Servidor MCP de Postman

Un servidor MCP (Protocolo de Contexto de Modelo) que permite ejecutar colecciones de Postman usando Newman. Este servidor permite a los LLMs ejecutar pruebas de API y obtener resultados detallados a través de una interfaz estandarizada.

Listado de Agentes de IA

Características

• Ejecutar colecciones de Postman usando Newman
• Soporte para archivos de entorno
• Soporte para variables globales
• Resultados de pruebas detallados que incluyen:
  • Estado general de éxito/fallo
  • Resumen de pruebas (total, aprobadas, fallidas)
  • Información detallada de fallos
  • Tiempos de ejecución

Instalación

Instalación mediante Smithery

Para instalar Postman Runner para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install mcp-postman --client claude

Instalación Manual

# Clone the repository
git clone <repository-url>
cd mcp-postman

# Install dependencies
pnpm install

# Build the project
pnpm build

Uso

Configuración

Agrega el servidor a tu archivo de configuración de Claude desktop en ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "postman-runner": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-postman/build/index.js"]
    }
  }
}

Herramientas Disponibles

run-collection

Ejecuta una colección de Postman y devuelve los resultados de las pruebas.

Parámetros:

• collection (obligatorio): Ruta o URL de la colección de Postman
• environment (opcional): Ruta o URL del archivo de entorno
• globals (opcional): Ruta o URL del archivo de variables globales
• iterationCount (opcional): Número de iteraciones a ejecutar

Ejemplo de Respuesta:

{
  "success": true,
  "summary": {
    "total": 5,
    "failed": 0,
    "passed": 5
  },
  "failures": [],
  "timings": {
    "started": "2024-03-14T10:00:00.000Z",
    "completed": "2024-03-14T10:00:01.000Z",
    "duration": 1000
  }
}

Ejemplo de Uso en Claude

Puedes usar el servidor en Claude pidiéndole que ejecute una colección de Postman:

"Ejecuta la colección de Postman en /path/to/collection.json y dime si todas las pruebas pasaron"

Claude:

1. Usará la herramienta run-collection
2. Analizará los resultados de las pruebas
3. Proporcionará un resumen amigable de la ejecución

Desarrollo

Estructura del Proyecto

src/
  ├── index.ts           # Entry point
  ├── server/
  │   ├── server.ts     # MCP Server implementation
  │   └── types.ts      # Type definitions
  └── newman/
      └── runner.ts     # Newman runner implementation
test/
  ├── server.test.ts    # Server tests
  ├── newman-runner.test.ts  # Runner tests
  └── fixtures/         # Test fixtures
      └── sample-collection.json

Ejecución de Pruebas

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

Compilación

# Build the project
pnpm build

# Clean build artifacts
pnpm clean

Contribuciones

1. Haz un fork del repositorio
2. Crea tu rama de características (git checkout -b feature/amazing-feature)
3. Realiza tus cambios (git commit -m 'Add some amazing feature')
4. Envía los cambios a la rama (git push origin feature/amazing-feature)
5. Abre una Solicitud de Extracción

Licencia

ISC