Serveur Mcp de Postman

Qu'est-ce que MCP Postman ?

MCP Postman est un serveur conçu pour exécuter des collections Postman en utilisant Newman, qui est un exécuteur de collections en ligne de commande pour Postman. Cet outil permet aux développeurs d'automatiser leurs flux de travail de test API en exécutant des collections directement depuis la ligne de commande, facilitant ainsi l'intégration dans les pipelines CI/CD.

Fonctionnalités de MCP Postman

• Intégration transparente : S'intègre facilement aux collections Postman existantes, permettant une configuration et une exécution rapides.
• Interface en ligne de commande : Utilise Newman pour exécuter des collections, offrant une CLI puissante pour l'automatisation.
• Rapports personnalisables : Génère des rapports détaillés des résultats des tests, aidant les développeurs à identifier rapidement les problèmes.
• Support des environnements : Prend en charge plusieurs environnements, permettant des scénarios de test flexibles.
• Répertoire public : Disponible sur GitHub, permettant la collaboration et les contributions de la communauté.

Comment utiliser MCP Postman

1. Installation : Tout d'abord, assurez-vous d'avoir Node.js installé sur votre machine. Ensuite, installez Newman globalement en utilisant npm :

   npm install -g newman
   

2. Cloner le dépôt : Clonez le dépôt MCP Postman depuis GitHub :

   git clone https://github.com/shannonlal/mcp-postman.git
   

3. Exécuter des collections : Accédez au répertoire cloné et exécutez votre collection Postman en utilisant Newman :

   newman run your-collection.json
   

4. Voir les rapports : Après avoir exécuté la collection, consultez les rapports générés pour analyser les résultats.

Questions Fréquemment Posées

Qu'est-ce que Newman ?

Newman est un outil en ligne de commande qui vous permet d'exécuter des collections Postman directement depuis le terminal. Il est essentiel pour automatiser les tests API et les intégrer dans les pipelines CI/CD.

Puis-je utiliser MCP Postman pour des tests automatisés ?

Oui, MCP Postman est spécifiquement conçu pour les tests automatisés des API en utilisant des collections Postman, ce qui le rend idéal pour les flux de travail d'intégration et de déploiement continus.

MCP Postman est-il open-source ?

Oui, MCP Postman est un projet open-source hébergé sur GitHub, permettant aux développeurs de contribuer et d'améliorer l'outil.

Comment puis-je contribuer à MCP Postman ?

Vous pouvez contribuer en forkant le dépôt, en apportant vos modifications et en soumettant une demande de tirage sur GitHub. Assurez-vous de suivre les directives de contribution fournies dans le dépôt.

Où puis-je trouver plus d'informations sur MCP Postman ?

Pour plus d'informations, vous pouvez visiter le dépôt GitHub de MCP Postman où vous pouvez trouver de la documentation, des problèmes et des discussions communautaires.

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.

<a href="https://glama.ai/mcp/servers/qfx34b2s2v"><img width="380" height="200" src="https://glama.ai/mcp/servers/qfx34b2s2v/badge" alt="Postman Server MCP server" /></a>

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:

1. Use the run-collection tool
2. Analyze the test results
3. 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

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

License

ISC