postman-mcp-server

postman-mcp-server

提供对 Postman 的无缝访问。

内容获取
AI集成系统
Git管理工具
访问服务器

Tools

add_pan_element

Add element or folder to Private API Network

update_pan_element

Update element or folder in Private API Network

remove_pan_element

Remove element or folder from Private API Network

create_webhook

Creates webhook that triggers collection with custom payload

get_tagged_elements

Get elements by tag

get_workspace_tags

Get workspace tags

update_workspace_tags

Update workspace tags

list_workspaces

List all workspaces

get_workspace

Get details of a specific workspace

list_environments

List all environments in a workspace. If workspace not specified, lists environments in "My Workspace".

get_environment

Get details of a specific environment

create_environment

Create a new environment in a workspace. Creates in "My Workspace" if workspace not specified.

update_environment

Update an existing environment. Only include variables that need to be modified.

delete_environment

Delete an environment

fork_environment

Create a fork of an environment in a workspace

get_environment_forks

Get a list of environment forks

merge_environment_fork

Merge a forked environment back into its parent

pull_environment

Pull changes from parent environment into forked environment

list_collections

List all collections in a workspace. Supports filtering and pagination.

get_collection

Get details of a specific collection

create_collection

Create a new collection in a workspace. Supports Postman Collection v2.1.0 format.

update_collection

Update an existing collection. Full collection replacement with maximum size of 20 MB.

patch_collection

Partially update a collection. Only updates provided fields.

delete_collection

Delete a collection

create_collection_folder

Create a new folder in a collection

get_collection_folder

Get details of a specific folder in a collection

update_collection_folder

Update a folder in a collection. Acts like PATCH, only updates provided values.

delete_collection_folder

Delete a folder from a collection

create_collection_request

Create a new request in a collection

get_collection_request

Get details of a specific request in a collection

update_collection_request

Update a request in a collection. Cannot change request folder.

delete_collection_request

Delete a request from a collection

create_collection_response

Create a new response in a collection

get_collection_response

Get details of a specific response in a collection

update_collection_response

Update a response in a collection. Acts like PATCH, only updates provided values.

delete_collection_response

Delete a response from a collection

fork_collection

Fork a collection to a workspace

get_collection_forks

Get a list of collection forks

merge_collection_fork

Merge a forked collection back into its parent

pull_collection_changes

Pull changes from parent collection into forked collection

transfer_collection_items

Transfer items between collections

get_user_info

Get information about the authenticated user

list_apis

List all APIs in a workspace

get_api

Get details of a specific API

create_api

Create a new API

update_api

Update an existing API

delete_api

Delete an API

add_api_collection

Add a collection to an API

get_api_collection

Get a specific collection from an API

create_api_schema

Create a schema for an API

get_api_schema

Get a specific schema from an API

create_api_version

Create a new version of an API

get_api_versions

Get all versions of an API

get_api_version

Get a specific version of an API

update_api_version

Update an API version

delete_api_version

Delete an API version

get_api_comments

Get comments for an API

create_api_comment

Create a new comment on an API (max 10,000 characters)

update_api_comment

Update an existing API comment (max 10,000 characters)

delete_api_comment

Delete an API comment

get_api_tags

Get tags for an API

update_api_tags

Update tags for an API

get_api_schema_files

Get files in an API schema

get_schema_file_contents

Get contents of a schema file

create_update_schema_file

Create or update a schema file

delete_schema_file

Delete a schema file

sync_collection_with_schema

Sync a collection with its schema

get_task_status

Get status of an asynchronous task

list_collection_access_keys

List collection access keys with optional filtering by collection ID

delete_collection_access_key

Delete a collection access key

list_workspace_roles

Get all available workspace roles based on team's plan

get_workspace_roles

Get roles for a specific workspace

update_workspace_roles

Update workspace roles for users and groups (limited to 50 operations per call)

get_collection_roles

Get roles for a collection

update_collection_roles

Update collection roles (requires EDITOR role)

get_authenticated_user

Get authenticated user information

list_mocks

List all mock servers

create_mock

Create a new mock server. Creates in Personal workspace if workspace not specified.

get_mock

Get details of a specific mock server

update_mock

Update an existing mock server

delete_mock

Delete a mock server

get_mock_call_logs

Get mock call logs. Maximum 6.5MB or 100 call logs per API call. Retention period based on Postman plan.

publish_mock

Publish mock server (sets Access Control to public)

unpublish_mock

Unpublish mock server (sets Access Control to private)

list_server_responses

Get all server responses for a mock

create_server_response

Create a server response. Only one server response can be active at a time.

get_server_response

Get a specific server response

update_server_response

Update a server response

delete_server_response

Delete a server response

list_monitors

Get all monitors

get_monitor

Get details of a specific monitor

create_monitor

Create a new monitor. Cannot create monitors for collections added to an API definition.

update_monitor

Update an existing monitor

delete_monitor

Delete a monitor

run_monitor

Run a monitor. For async=true, response won't include stats, executions, and failures. Use GET /monitors/{id} to get this information for async runs.

get_accounts

Gets Postman billing account details for the given team

list_account_invoices

Gets all invoices for a Postman billing account filtered by status

resolve_comment_thread

Resolves a comment and any associated replies

list_pan_elements

Get all elements and folders in Private API Network

README

Postman MCP 服务器

smithery badge 版本: v0.2.0

一个 MCP 服务器,提供对 Postman API 的访问。功能基于 官方 OpenAPI 规范。 更多信息,请参阅 Postman API 文档

本项目是 Anthropic 的模型上下文协议 (MCP) 倡议的一部分。 更多信息,请访问 MCP GitHub 仓库Anthropic 博客上的公告

跳至安装说明

postman-mcp-server - 封面图片

[!WARNING] 本项目目前正在积极开发中。请谨慎使用,并预期会有重大更改。

[!NOTE] AI 生成代码。我使用了 Cline v2.2.2 和 Claude 3.5 Sonnet (2024-10-22)。 有关代码生成方式的提示和详细信息,请参阅 docs/README.md。

<a href="https://glama.ai/mcp/servers/zoig549xfd"><img width="380" height="200" src="https://glama.ai/mcp/servers/zoig549xfd/badge" alt="postman-mcp-server MCP server" /></a>


概述

Postman MCP Server 是一个基于 TypeScript 的 MCP 服务器,它与 Postman API 集成,提供对 Postman 集合、环境和 API 的全面管理。

特性

集合

  • CRUD 操作: 创建、检索、更新和删除 Postman 集合。
  • 文件夹管理: 将请求组织到集合中的文件夹中。
  • 请求管理: 在集合中添加、更新和删除请求。
  • 响应管理: 管理与请求关联的响应。
  • 版本控制: Fork、合并和拉取集合的更改。
  • 评论: 添加和管理集合上的评论。

环境

  • 管理环境: 创建和检索不同设置的环境。
  • CRUD 操作: 完全支持创建、更新和删除环境。

API

  • API 管理: 创建、检索、更新和删除 API。
  • 模式支持: 管理具有多文件支持的 API 模式。
  • 标签: 添加和管理 API 的标签。
  • 评论: 添加和管理 API 上的评论。

身份验证 & 授权

  • API 密钥身份验证: 使用 API 密钥安全访问。
  • 基于角色的访问控制: 管理工作区和集合级别的权限。
  • 工作区权限: 定义特定于工作区的权限。

附加特性

  • 私有 API 网络: 管理私有 API 网络中的元素和文件夹。
  • Webhooks: 创建 webhooks 以使用自定义有效负载触发集合。
  • 企业特性: 用于企业环境的高级角色控制和 SCIM 支持。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Postman MCP Server:

npx -y @smithery/cli install postman-api-server --client claude

先决条件

步骤

  1. 克隆仓库:

    git clone https://github.com/delano/postman-api-server.git
    cd postman-api-server
    
  2. 安装依赖:

    pnpm install
    
  3. 构建服务器:

    pnpm run build
    
  4. 以自动重建的开发模式运行:

    pnpm run watch
    

使用

设置 API 密钥

  1. 生成您的 API 密钥

    • 访问 Postman 帐户设置
    • 点击 "生成 API 密钥"
    • 安全地保存密钥 - 它不会再次显示
  2. 配置 API 密钥

    • 将密钥作为 POSTMAN_API_KEY 添加到您的环境中
    • 对于 Claude Desktop 或 Cline,将其包含在您的配置文件中(请参阅下面的配置示例)
    • 永远不要将 API 密钥提交到版本控制
  3. 验证访问

    • API 密钥提供对您拥有权限的所有 Postman 资源的访问权限
    • 通过运行一个简单的查询(例如,列出工作区)来测试访问

[!NOTE] 如果您直接使用 Postman API 集合,请将您的 API 密钥存储为 postman-api-key 集合变量。

使用 Claude Desktop

要与 Claude Desktop 一起使用,请添加服务器配置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

[!IMPORTANT] 如果您正在更新此提供程序,则必须重新启动 Claude 才能从输入模式中获取 API 更改(即,当 MCP 服务器的 ToolDefinition 元素已更改时)。 这是因为 Claude 在启动时会缓存工具定义。

<img width="480" alt="claude-desktop-settings" src="https://github.com/user-attachments/assets/7ea7cba2-e27e-413a-a50a-590054d51344" />

配置示例

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

使用 Cline

使用相同的示例配置,将服务器配置添加到您的 Cline MCP 服务器配置:

<img width="480" alt="cline-settings" src="https://github.com/user-attachments/assets/651ec517-9aa2-4314-84f5-bee716aa8889" />

配置示例

与上面的 Claude 相同。

使用 Zed

我仍在尝试使其工作。 从 Zed 文档 来看,它需要是一个扩展 (还有这个问题 #21455)。


文档

官方 Postman API 文档 可在 Postman 公共工作区 中找到。

项目概述

Postman API 参考 & 摘要

本项目利用 Claude 模型和 Cline 扩展将 OpenAPI 规范转换为 TypeScript 代码,从而增强了类型安全性和在 MCP 服务器中的集成。

此 GitHub 项目包含 API 参考文档,其中提供了有关以编程方式利用 Postman 平台的详细指导。 它涵盖了用于本地开发的 Collection SDK 和用于云平台集成的 Postman API。 主要主题包括身份验证机制、速率限制以及所有 API 端点的深入文档,包括工作区、集合、环境、模拟服务器、监视器等。 此外,该指南还提供了先决条件和快速入门说明,以方便无缝的 API 交互。

docs/api/summaries 目录包含 Postman API 的全面 Markdown 摘要。 这些文档概述了 API 端点、请求/响应格式以及对于验证和确保 MCP 服务器功能至关重要的实现细节。 有关文档结构和实现策略的概述,请参阅 API 摘要 README

使用 Claude 将 OpenAPI 规范转换为 TypeScript 代码

构建 MCP 服务器

有关实现 MCP 服务器处理程序的详细规范,请参阅 处理程序文档。 这包括 URI 格式、提示要求和资源处理模式。 本指南对于开发人员在 MCP 服务器中集成和增强 Postman API 功能至关重要。


原理

Postman 工具的 MCP 包装器主要作为 AI 交互层,适用于结构和安全性至关重要的复杂、多步骤操作。 但是,对于直接使用 CLI 或 API 即可满足的简单操作,它可能过于复杂。 MCP 包装器在以下情况下提供最大价值:

  1. 复杂操作
  • 管理多个集合
  • 协调环境
  • 生成综合报告
  1. AI 驱动的自动化
  • 自动化测试工作流程
  • API 文档维护
  • 环境管理
  1. 对错误敏感的操作
  • 关键 API 测试
  • 生产部署
  • 合规性检查

它在以下情况下提供的价值较小:

  1. 简单操作
  • 基本集合运行
  • 单个 API 调用
  • 快速环境检查
  1. 直接 CLI 使用
  • 开发人员驱动的操作
  • 本地测试
  • 快速迭代

开发

安装依赖:

pnpm install

构建服务器:

pnpm run build

对于具有自动重建的开发:

pnpm run watch

调试

由于 MCP 服务器通过 stdio 进行通信,因此调试可能具有挑战性。 我们建议使用 MCP Inspector,它作为包脚本提供:

pnpm run inspector

文档

Inspector 将提供一个 URL 以访问浏览器中的调试工具:http://localhost:5173。 您需要在连接之前添加 POSTMAN_API_KEY。 导航到 "工具" 以开始使用。

其他 MCP 服务器

许可证

本项目根据 MIT 许可证获得许可。 有关详细信息,请参阅 LICENSE 文件。

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
mcp-server-qdrant

mcp-server-qdrant

这个仓库展示了如何为向量搜索引擎 Qdrant 创建一个 MCP (Managed Control Plane) 服务器的示例。

官方
精选
mult-fetch-mcp-server

mult-fetch-mcp-server

一个多功能的、符合 MCP 规范的网页内容抓取工具,支持多种模式(浏览器/Node)、格式(HTML/JSON/Markdown/文本)和智能代理检测,并提供双语界面(英语/中文)。

精选
本地
AIO-MCP Server

AIO-MCP Server

🚀 集成了 AI 搜索、RAG 和多服务(GitLab/Jira/Confluence/YouTube)的一体化 MCP 服务器,旨在增强 AI 驱动的开发工作流程。来自 Folk。

精选
本地
Knowledge Graph Memory Server

Knowledge Graph Memory Server

为 Claude 实现持久性记忆,使用本地知识图谱,允许 AI 记住用户的信息,并可在自定义位置存储,跨对话保持记忆。

精选
本地
Hyperbrowser

Hyperbrowser

欢迎来到 Hyperbrowser,人工智能的互联网。Hyperbrowser 是下一代平台,旨在增强人工智能代理的能力,并实现轻松、可扩展的浏览器自动化。它专为人工智能开发者打造,消除了本地基础设施和性能瓶颈带来的麻烦,让您能够:

精选
本地
https://github.com/Streen9/react-mcp

https://github.com/Streen9/react-mcp

react-mcp 与 Claude Desktop 集成,能够根据用户提示创建和修改 React 应用程序。

精选
本地
MCP Atlassian

MCP Atlassian

适用于 Atlassian Cloud 产品(Confluence 和 Jira)的 Model Context Protocol (MCP) 服务器。此集成专为 Atlassian Cloud 实例设计,不支持 Atlassian Server 或 Data Center 部署。

精选
any-chat-completions-mcp

any-chat-completions-mcp

将 Claude 与任何 OpenAI SDK 兼容的聊天完成 API 集成 - OpenAI、Perplexity、Groq、xAI、PyroPrompts 等。

精选