Postman MCP Server

🚀 郵件投遞員（Postman）項目文檔

本項目是一個為郵件投遞協議（MCP）設計的郵差（Postman）工具集。藉助該工具，可通過AI模型與Postman API進行交互，執行復雜的操作任務。

🚀 快速開始

若你想快速上手本項目，可按以下步驟操作：

安裝依賴

pnpm install

構建服務器

pnpm run build

開發模式（自動重建）

pnpm run watch

✨ 主要特性

• 利用Claude模型和Cline擴展，將OpenAPI規範轉換為TypeScript代碼，增強類型安全性和集成性。
• 提供本地開發的Collection SDK，支持本地環境的手動操作。
• 支持雲平臺的Postman API，可進行在線平臺的操作。
• 詳細講解Postman API的各種認證方法及調用頻率限制。
• 提供全面的API端點文檔，涵蓋工作區、集合、環境、模擬服務器、監控等核心功能。

📦 安裝指南

安裝依賴

pnpm install

構建服務器

pnpm run build

開發模式（自動重建）

pnpm run watch

💻 使用示例

基礎用法

Claude配置

在Claude中添加以下配置到~/.config/claude/mcp-servers.json：

{
  "postman": {
    "command": "node",
    "args": ["path/to/postman-api-server/build/index.js"],
    "env": {
      "POSTMAN_API_KEY": "your_api_key_here"
    }
  }
}

Cline配置

在Cline中添加以下內容到~/.config/clinetl/mcp-servers.json：

{
  "postman": {
    "command": "node",
    "args": ["path/to/postman-api-server/build/index.js"],
    "env": {
      "POSTMAN_API_KEY": "your_api_key_here"
    }
  }
}

Zed配置

目前仍在嘗試解決該問題。根據Zed文檔，它需要作為擴展使用（參考此問題#21455）。

📚 詳細文檔

項目概述

Postman API參考資料與摘要

本項目利用Claude模型和Cline擴展，將OpenAPI規範轉換為TypeScript代碼，從而增強類型安全性和集成性。該項目在GitHub上包含API參考資料文檔，提供了詳細的指導，說明如何通過編程方式使用Postman平臺。 主要內容包括：

• 本地開發的Collection SDK：用於本地環境的手動操作。
• 雲平臺的Postman API：用於在線平臺的操作。
• 身份驗證機制：詳細講解Postman API的各種認證方法。
• 速率限制：說明Postman API的調用頻率限制。
• 全面的API端點文檔：涵蓋工作區、集合、環境、模擬服務器、監控等核心功能。 此外，該指南還提供了使用Postman API的先決條件和快速入門指南。docs/api/summaries目錄下包含詳細的Markdown格式摘要文件，為開發者提供全面的技術支持。

🔧 技術細節

由於MCP服務器通過標準輸入和輸出進行通信，調試較為困難。我們推薦使用MCP Inspector，它提供了一個圖形化界面幫助開發者調試。 運行以下命令啟動Inspector：

pnpm run inspector

訪問http://localhost:9001即可查看即時日誌和調試信息。

📄 許可證

本項目遵循MIT許可證，具體條款請參考LICENSE文件。