Postmancer

🚀 Postman Manager

An independent MCP server for API testing and management, enabling AI assistants to interact with RESTful APIs through natural language.

🚀 Quick Start

📦 Installation

# Global installation
npm install -g postmancer

# Or run directly
npx postmancer

Integrate with Claude Desktop

Add the following content to your Claude Desktop configuration file:

• On Windows: %USERPROFILE%\.claude\claude_desktop_config.json
• On macOS/Linux: ~/.claude/claude_desktop_config.json

{
  "mcpServers": {
    "postmancer": {
      "command": "npx",
      "args": ["-y", "postmancer"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

Use Docker

docker run -i --rm \
  --mount type=bind,src=/path/to/collections,dst=/data/collections \
  postmancer

✨ Features

• Send HTTP requests to any REST API.
• Save and organize requests into favorites.
• Set and use environment variables for variable substitution.
• Support multiple authentication methods (Basic Auth, Bearer Token, API Key, OAuth2).
• Provide request/response history and testing capabilities.

💻 Usage Examples

Available Tools

Postmancer provides the following tools for AI assistants:

1. http_request - Send an HTTP request to any URL.
2. list_collections - View all saved API collections.
3. list_requests - View all requests in a collection.
4. save_request - Save a request to a collection.
5. request_from_collection - Execute a saved request.
6. set_environment_variable - Set an environment variable in a request template.
7. get_environment_variables - View all environment variables.

📚 Documentation

Configuration

Configure Postmancer through the following environment variables:

In a production environment, it is strongly recommended to set these encryption keys to ensure security instead of using the default values.

📄 License

MIT