convez.ai
PluginIntegração & APIsIntermediário
hijaz

Postmancer

hijaz/postmancer

Cliente REST para IA testar e gerenciar APIs via linguagem natural

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para testes e gerenciamento de APIs REST, permitindo que assistentes IA façam requisições HTTP, organizem coleções de endpoints e gerenciem ambientes. Funciona como Postman/Insomnia mas integrado nativamente com Claude através do protocolo MCP.

Instalação

$npx convez-ai hijaz/postmancer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
29
Forks
5
Acompanhando
1
Saúde
57%
Último commit
há 1 ano
Versão
—
Issues abertas
2
Contribuidores
3

Casos de uso

  • Testar endpoints de API durante desenvolvimento sem sair do Claude
  • Automatizar chains de requisições HTTP com variáveis de ambiente
  • Organizar e reutilizar coleções de requests para múltiplas APIs
  • Validar respostas de API e fazer debugging com histórico de requisições

Veredito

Postmancer preenche um gap real: testes de API dentro do fluxo conversacional com Claude. Bem implementado (TypeScript, MCP padrão), com autenticação multi-método e persistência de collections. Recomendado para devs que precisam integrar testes API em workflows IA.

README

A tradução para o português deste README ainda está na fila.

MseeP.ai Security Assessment Badge

Postmancer

Trust Score

Postmancer

A standalone MCP server for API testing and management, allowing AI assistants to interact with RESTful APIs through natural language.

Overview

Postmancer is an MCP (Model Context Protocol) server that enables AI assistants like Claude to make HTTP requests, manage collections of API endpoints, and test API responses. It provides similar functionality to tools like Postman or Insomnia but designed specifically for AI assistants.

Features

  • Make HTTP requests to any REST API
  • Save and organize requests in collections
  • Set and use environment variables with variable substitution
  • Multiple authentication methods (Basic, Bearer, API Key, OAuth2)
  • Request/response history and testing

Quick Start

Installation

# Install globally
npm install -g postmancer

# Or run directly with npx
npx postmancer

Using with Claude Desktop

Add this to your Claude Desktop configuration file:

  • Windows: %USERPROFILE%\.claude\claude_desktop_config.json
  • macOS/Linux: ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "postmancer": {
      "command": "npx",
      "args": ["-y", "postmancer"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

Using with Docker

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

Available Tools

Postmancer provides the following tools to AI assistants:

  1. http_request - Send HTTP requests to any URL
  2. list_collections - View all your 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 variables for request templates
  7. get_environment_variables - View all environment variables

Configuration

Configure Postmancer with these environment variables:

  • COLLECTIONS_PATH: Path to store collections (default: ~/.postmancer)
  • LOG_LEVEL: Logging level (debug, info, warn, error) (default: info)
  • POSTMANCER_ENCRYPTION_KEY: Secret key used to encrypt credentials and tokens (generates a random key if not provided)
  • ENCRYPTION_KEY: Secret key used to encrypt environment variables marked as secrets (uses default key if not provided)

For security in production environments, it's strongly recommended to set these encryption keys rather than using the defaults.

License

MIT

Ver o original no GitHub

Bom para

Relacionados