Servidor Mcp de Postman

Resumen

¿Qué es MCP Postman?

MCP Postman es un servidor diseñado para ejecutar colecciones de Postman utilizando Newman, que es un ejecutor de colecciones de línea de comandos para Postman. Esta herramienta permite a los desarrolladores automatizar sus flujos de trabajo de pruebas de API al ejecutar colecciones directamente desde la línea de comandos, facilitando la integración en pipelines de CI/CD.

Características de MCP Postman

Integración sin problemas: Se integra fácilmente con colecciones de Postman existentes, permitiendo una configuración y ejecución rápidas.
Interfaz de línea de comandos: Utiliza Newman para ejecutar colecciones, proporcionando una poderosa CLI para la automatización.
Informes personalizables: Genera informes detallados de los resultados de las pruebas, ayudando a los desarrolladores a identificar rápidamente problemas.
Soporte para múltiples entornos: Soporta múltiples entornos, permitiendo escenarios de prueba flexibles.
Repositorio público: Disponible en GitHub, lo que permite la colaboración y contribuciones de la comunidad.

Cómo usar MCP Postman

Instalación: Primero, asegúrate de tener Node.js instalado en tu máquina. Luego, instala Newman globalmente usando npm:
```
npm install -g newman
```
Clonar el repositorio: Clona el repositorio de MCP Postman desde GitHub:
```
git clone https://github.com/shannonlal/mcp-postman.git
```
Ejecutar colecciones: Navega al directorio clonado y ejecuta tu colección de Postman usando Newman:
```
newman run your-collection.json
```
Ver informes: Después de ejecutar la colección, visualiza los informes generados para analizar los resultados.

Preguntas frecuentes

¿Qué es Newman?

Newman es una herramienta de línea de comandos que te permite ejecutar colecciones de Postman directamente desde la terminal. Es esencial para automatizar pruebas de API e integrarlas en pipelines de CI/CD.

¿Puedo usar MCP Postman para pruebas automatizadas?

Sí, MCP Postman está diseñado específicamente para pruebas automatizadas de APIs utilizando colecciones de Postman, lo que lo hace ideal para flujos de trabajo de integración y despliegue continuo.

¿Es MCP Postman de código abierto?

Sí, MCP Postman es un proyecto de código abierto alojado en GitHub, lo que permite a los desarrolladores contribuir y mejorar la herramienta.

¿Cómo puedo contribuir a MCP Postman?

Puedes contribuir bifurcando el repositorio, haciendo tus cambios y enviando una solicitud de extracción en GitHub. Asegúrate de seguir las pautas de contribución proporcionadas en el repositorio.

¿Dónde puedo encontrar más información sobre MCP Postman?

Para más información, puedes visitar el repositorio de GitHub de MCP Postman donde puedes encontrar documentación, problemas y discusiones de la comunidad.

Detalle

Postman MCP Server

An MCP (Model Context Protocol) server that enables running Postman collections using Newman. This server allows LLMs to execute API tests and get detailed results through a standardized interface.

Features

Run Postman collections using Newman
Support for environment files
Support for global variables
Detailed test results including:
- Overall success/failure status
- Test summary (total, passed, failed)
- Detailed failure information
- Execution timings

Installation

Installing via Smithery

To install Postman Runner for Claude Desktop automatically via Smithery:

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

Manual Installation

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

### Install dependencies
pnpm install

### Build the project
pnpm build

Usage

Configuration

Add the server to your Claude desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Available Tools

run-collection

Runs a Postman collection and returns the test results.

Parameters:

collection (required): Path or URL to the Postman collection
environment (optional): Path or URL to environment file
globals (optional): Path or URL to globals file
iterationCount (optional): Number of iterations to run

Example Response:

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

Example Usage in Claude

You can use the server in Claude by asking it to run a Postman collection:

"Run the Postman collection at /path/to/collection.json and tell me if all tests passed"

Claude will:

Use the run-collection tool
Analyze the test results
Provide a human-friendly summary of the execution

Development

Project Structure

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

Running Tests

### Run tests
pnpm test

### Run tests with coverage
pnpm test:coverage

Building

### Build the project
pnpm build

### Clean build artifacts
pnpm clean

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

ISC

{ "mcpServers": { "mcp-postman": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/metorial/mcp-container--shannonlal--mcp-postman--mcp-postman", "node ./build/index.js" ], "env": {} } } }