hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows running Postman collections using Newman, executing API tests and getting detailed results through a standardized interface

Servidor MCP de Postman

Un servidor MCP (Protocolo de Contexto de Modelo) que permite ejecutar colecciones Postman con Newman. Este servidor permite a los LLM ejecutar pruebas de API y obtener resultados detallados mediante una interfaz estandarizada.

Características

Ejecutar colecciones de Postman usando Newman
Soporte para archivos de entorno
Soporte para variables globales
Resultados detallados de las pruebas que incluyen:
- Estado general de éxito/fracaso
- Resumen de la prueba (total, aprobado, reprobado)
- Información detallada sobre fallos
- Tiempos de ejecución

Instalación

Instalación mediante herrería

Para instalar Postman Runner para Claude Desktop automáticamente a través de 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

Agregue el servidor a su archivo de configuración de escritorio Claude 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

colección de carreras

Ejecuta una colección de Postman y devuelve los resultados de la prueba.

Parámetros:

collection (obligatorio): Ruta o URL a la colección de Postman
environment (opcional): Ruta o URL al archivo de entorno
globals (opcional): Ruta o URL al archivo global
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 recopilación de Postman:

Ejecute la colección Postman en /path/to/collection.json y dígame si se aprobaron todas las pruebas.

Claude querrá:

Utilice la herramienta de recopilación de ejecuciones
Analizar los resultados de las pruebas
Proporcionar un resumen comprensible 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

Edificio

# Build the project
pnpm build

# Clean build artifacts
pnpm clean

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

ISC

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

run-collection

Permite ejecutar colecciones de Postman utilizando Newman para realizar pruebas de API y obtener análisis de resultados detallados a través de una interfaz estandarizada.

Related Resources

Reddit Discussion about this server

Postman MCP Server