postman-mcp-server
提供对 Postman 的无缝访问。
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 服务器
一个 MCP 服务器,提供对 Postman API 的访问。功能基于 官方 OpenAPI 规范。 更多信息,请参阅 Postman API 文档。
本项目是 Anthropic 的模型上下文协议 (MCP) 倡议的一部分。 更多信息,请访问 MCP GitHub 仓库 和 Anthropic 博客上的公告。
[!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
先决条件
- 已安装 Node.js。
步骤
-
克隆仓库:
git clone https://github.com/delano/postman-api-server.git cd postman-api-server -
安装依赖:
pnpm install -
构建服务器:
pnpm run build -
以自动重建的开发模式运行:
pnpm run watch
使用
设置 API 密钥
-
生成您的 API 密钥
- 访问 Postman 帐户设置
- 点击 "生成 API 密钥"
- 安全地保存密钥 - 它不会再次显示
-
配置 API 密钥
- 将密钥作为
POSTMAN_API_KEY添加到您的环境中 - 对于 Claude Desktop 或 Cline,将其包含在您的配置文件中(请参阅下面的配置示例)
- 永远不要将 API 密钥提交到版本控制
- 将密钥作为
-
验证访问
- 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 包装器在以下情况下提供最大价值:
- 复杂操作
- 管理多个集合
- 协调环境
- 生成综合报告
- AI 驱动的自动化
- 自动化测试工作流程
- API 文档维护
- 环境管理
- 对错误敏感的操作
- 关键 API 测试
- 生产部署
- 合规性检查
它在以下情况下提供的价值较小:
- 简单操作
- 基本集合运行
- 单个 API 调用
- 快速环境检查
- 直接 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
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
mcp-server-qdrant
这个仓库展示了如何为向量搜索引擎 Qdrant 创建一个 MCP (Managed Control Plane) 服务器的示例。
mult-fetch-mcp-server
一个多功能的、符合 MCP 规范的网页内容抓取工具,支持多种模式(浏览器/Node)、格式(HTML/JSON/Markdown/文本)和智能代理检测,并提供双语界面(英语/中文)。
AIO-MCP Server
🚀 集成了 AI 搜索、RAG 和多服务(GitLab/Jira/Confluence/YouTube)的一体化 MCP 服务器,旨在增强 AI 驱动的开发工作流程。来自 Folk。
Knowledge Graph Memory Server
为 Claude 实现持久性记忆,使用本地知识图谱,允许 AI 记住用户的信息,并可在自定义位置存储,跨对话保持记忆。
Hyperbrowser
欢迎来到 Hyperbrowser,人工智能的互联网。Hyperbrowser 是下一代平台,旨在增强人工智能代理的能力,并实现轻松、可扩展的浏览器自动化。它专为人工智能开发者打造,消除了本地基础设施和性能瓶颈带来的麻烦,让您能够:
https://github.com/Streen9/react-mcp
react-mcp 与 Claude Desktop 集成,能够根据用户提示创建和修改 React 应用程序。
MCP Atlassian
适用于 Atlassian Cloud 产品(Confluence 和 Jira)的 Model Context Protocol (MCP) 服务器。此集成专为 Atlassian Cloud 实例设计,不支持 Atlassian Server 或 Data Center 部署。
any-chat-completions-mcp
将 Claude 与任何 OpenAI SDK 兼容的聊天完成 API 集成 - OpenAI、Perplexity、Groq、xAI、PyroPrompts 等。