freebeiro_mcp_postman
by freebeiroPostman MCP Server for Claude AI
Overview
The Postman MCP Server is a Cloudflare Worker that provides API access to Postman collections and environments via the Claude AI MCP (Model Control Plane) interface. This server enables Claude AI to interact with your Postman collections and environments, allowing for operations such as retrieving, creating, and running collections, as well as managing environments. This integration facilitates API testing, documentation, and management tasks within your workflows.
Current Methods
Basic Utility Methods
mcp__sayHello(name)- Returns a greeting with the provided namemcp__reverseString(input)- Reverses the characters in a string
Collection Methods
mcp__get_collections()- Gets all collections in your Postman accountmcp__get_collection(collectionId)- Gets details for a specific collectionmcp__create_collection(name, description)- Creates a new collectionmcp__add_request(collectionId, name, method, url, ...)- Adds a request to a collection
Environment Methods
mcp__get_environments()- Gets all environments in your Postman accountmcp__get_environment(environmentId)- Gets details for a specific environmentmcp__create_environment(name, variables)- Creates a new environment with variables
Test Execution
mcp__run_collection(collectionId, environmentId)- Runs a collection with an optional environment
Getting Started
- Clone this repository
- Install dependencies:
npm install - Copy
.env.exampleto.envand add your Postman API key - Deploy to Cloudflare Workers:
wrangler deploy
Development
To run the server locally for development:
npm run dev
This will start the server locally using wrangler.
Project Structure
/src- Source code/interfaces- TypeScript interfaces/services- Service classesindex.ts- Main worker entry point/test- Unit tests/examples- Example usage/docs- Additional documentation
Examples
See the examples/postman-examples.md file for detailed examples of how to use the Postman MCP Server with Claude AI.
Deployment
To deploy to Cloudflare Workers:
npm run deploy
Make sure your wrangler.toml file is configured properly.
Security
This server requires a Postman API key to function. Ensure that your key is stored securely in the Cloudflare Workers environment variables and not committed to version control.
Contributing
- Follow the DEVELOPMENT_GUIDELINES.md
- Adhere to SOLID_PRINCIPLES.md for code design
License
MIT License
About
A Model Context Protocol (MCP) server built with Cloudflare Workers for integration with Claude and other AI assistants
Resources
Stars
Watchers
Forks
No releases published
No packages published
Invite Gmail Contacts
