Postman Mcp Сервер

Что такое MCP Postman?

MCP Postman — это сервер, предназначенный для запуска коллекций Postman с использованием Newman, который является инструментом командной строки для запуска коллекций Postman. Этот инструмент позволяет разработчикам автоматизировать свои рабочие процессы тестирования API, выполняя коллекции непосредственно из командной строки, что упрощает интеграцию в CI/CD пайплайны.

Особенности MCP Postman

• Бесшовная интеграция: Легко интегрируется с существующими коллекциями Postman, позволяя быстро настраивать и выполнять тесты.
• Интерфейс командной строки: Использует Newman для запуска коллекций, предоставляя мощный CLI для автоматизации.
• Настраиваемые отчеты: Генерирует подробные отчеты о результатах тестов, помогая разработчикам быстро выявлять проблемы.
• Поддержка окружений: Поддерживает несколько окружений, позволяя гибко настраивать сценарии тестирования.
• Публичный репозиторий: Доступен на GitHub, что позволяет сообществу сотрудничать и вносить свой вклад.

Как использовать MCP Postman

1. Установка: Сначала убедитесь, что у вас установлен Node.js на вашем компьютере. Затем установите Newman глобально с помощью npm:

   npm install -g newman
   

2. Клонирование репозитория: Клонируйте репозиторий MCP Postman с GitHub:

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

3. Запуск коллекций: Перейдите в клонированный каталог и запустите вашу коллекцию Postman с помощью Newman:

   newman run your-collection.json
   

4. Просмотр отчетов: После выполнения коллекции просмотрите сгенерированные отчеты для анализа результатов.

Часто задаваемые вопросы

Что такое Newman?

Newman — это инструмент командной строки, который позволяет запускать коллекции Postman непосредственно из терминала. Он необходим для автоматизации тестов API и их интеграции в CI/CD пайплайны.

Могу ли я использовать MCP Postman для автоматизированного тестирования?

Да, MCP Postman специально разработан для автоматизированного тестирования API с использованием коллекций Postman, что делает его идеальным для рабочих процессов непрерывной интеграции и развертывания.

Является ли MCP Postman открытым исходным кодом?

Да, MCP Postman — это проект с открытым исходным кодом, размещенный на GitHub, что позволяет разработчикам вносить свой вклад и улучшать инструмент.

Как я могу внести свой вклад в MCP Postman?

Вы можете внести свой вклад, сделав форк репозитория, внеся изменения и отправив запрос на слияние на GitHub. Обязательно следуйте рекомендациям по внесению вклада, представленным в репозитории.

Где я могу найти больше информации о MCP Postman?

Для получения дополнительной информации вы можете посетить репозиторий MCP Postman на GitHub, где вы найдете документацию, проблемы и обсуждения сообщества.

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