postman-mcp

codeprakhar25/postman-mcp

3.1

If you are the rightful owner of postman-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Model Context Protocol (MCP) server is designed to facilitate seamless integration between Postman collections and development environments like Cursor IDE, enabling efficient data access and automation.

Tools
2
Resources
0
Prompts
0

Postman Collection ExporternnA powerful tool to extract complete Postman collection information including requests, URLs, bodies, headers, and more using Postman credentials. Perfect for developers who want to automate the process of accessing their Postman collections without manually navigating the Postman interface.nn## Featuresnn- 🔐 Secure Authentication: Support for Postman API Key and OAuthn- 📦 Complete Collection Export: Extract all requests, environments, and variablesn- 📁 Multiple Export Formats: JSON, YAML, Markdown, and structured filesn- 🤖 MCP Integration: Model Context Protocol server for Cursor IDE integrationn- 🔍 Detailed Request Info: URLs, methods, headers, bodies, tests, and documentationn- ⚡ Fast & Efficient: Batch processing for large collectionsnn## Use Casesnn1. Documentation Generation: Automatically create API documentation from Postman collectionsn2. Code Generation: Extract request details for generating client coden3. Testing Automation: Export collection data for automated testing frameworksn4. Cursor Integration: Use MCP server to access Postman data directly in Cursor IDEn5. Backup & Migration: Create backups of your Postman collectionsnn## Quick Startnn### Prerequisitesnn- Python 3.8+n- Postman account with API accessn- Postman API Key (get it from Postman Settings)nn### Installationnnbashn# Clone the repositoryngit clone <your-repo-url>ncd Postman-MCPnn# Install dependenciesnpip install -r requirements.txtnn# Set up environment variablesncp .env.example .envn# Edit .env with your Postman API keynnn### Basic Usagennbashn# Export a specific collectionnpython postman_exporter.py --collection-id <collection-id> --output-format jsonnn# Export all collectionsnpython postman_exporter.py --all-collections --output-format markdownnn# Use MCP servernpython mcp_server.pynnn## ConfigurationnnCreate a .env file with your Postman credentials:nnenvnPOSTMAN_API_KEY=your_api_key_herenPOSTMAN_WORKSPACE_ID=your_workspace_id_herennn## MCP IntegrationnnThe MCP server allows Cursor IDE to directly access your Postman collections:nnjsonn{n "mcpServers": {n "postman": {n "command": "python",n "args": ["mcp_server.py"],n "env": {n "POSTMAN_API_KEY": "your_api_key_here"n }n }n }n}nnn## Project StructurennnPostman-MCP/n├── postman_exporter.py # Main exporter scriptn├── mcp_server.py # MCP server for Cursor integrationn├── postman_api.py # Postman API clientn├── exporters/ # Export format handlersn│ ├── json_exporter.pyn│ ├── yaml_exporter.pyn│ └── markdown_exporter.pyn├── utils/ # Utility functionsn│ ├── auth.pyn│ └── helpers.pyn├── requirements.txt # Python dependenciesn├── .env.example # Environment variables templaten└── README.md # This filennn## API Referencenn### PostmanExporter Classnnpythonnfrom postman_exporter import PostmanExporternnexporter = PostmanExporter(api_key="your_key")ncollection = exporter.get_collection("collection_id")nexporter.export_to_file(collection, "output.json", "json")nnn### MCP Server Commandsnn- get_collections(): List all collectionsn- get_collection(collection_id): Get specific collection detailsn- export_collection(collection_id, format): Export collection in specified formatnn## Contributingnn1. Fork the repositoryn2. Create a feature branchn3. Make your changesn4. Add testsn5. Submit a pull requestnn## LicensennMIT License - see LICENSE file for details