Cursor Postman Plugin

游标邮递员插件

Cursor内部的完整API生命周期管理。同步集合、生成类型化客户端代码、发现API、运行测试、创建模拟、改进文档和审计安全性。由 邮递员MCP服务器.

注： 此插件反映了 克劳德代码的邮递员插件，这是Postman的AI编码代理插件的真实来源。

此插件的功能

该插件通过Postman MCP服务器将Cursor连接到您的Postman帐户，并捆绑了专门构建的命令、技能和API就绪度分析器。一次安装即可获得：

• 8个命令 涵盖整个API生命周期
• 3种自动加载技能 教代理如何有效地使用Postman
• 1名次级代理人 用于深入的API准备情况分析（在8个支柱上进行48次检查）
• API设计规则 注射到每个疗程中
• 零配置MCP设置 （只需带上API密钥）

先决条件

• 光标 2.5+
• A. 邮递员帐户 （免费版作品）
• 邮差API密钥

安装

来自Cursor市场

马上就来： Cursor Marketplace列表和 /add-plugin 支持尚未提供。现在使用下面的GitHub或本地安装方法。

1. 打开的游标
2. 跑 /add-plugin postman 或浏览 市场
3. 设置API密钥（请参阅下面的设置）

来自GitHub

/add-plugin Postman-Devrel/cursor-postman-plugin

本地开发

/add-plugin /path/to/cursor-postman-plugin

设置

1.获取Postman API密钥

1. 首选 邮差API钥匙
2. 点击 生成API密钥
3. 将其命名为“游标插件”并复制密钥（以开头 PMAK-)

2.设置环境变量

添加到您的shell配置文件(~/.zshrc, ~/.bashrc，或 ~/.bash_profile):

export POSTMAN_API_KEY=PMAK-your-key-here

重新启动终端（或运行 source ~/.zshrc).

3.验证连接

在Cursor中，运行：

/postman:setup

这将验证您的API密钥，列出您的工作区，并确认所有内容都已连接。

命令

/postman:setup --首次运行配置

指导您完成API密钥设置，验证MCP连接，并列出您的工作空间。

/postman:sync --同步收藏

根据您当地的OpenAPI规范创建或更新Postman集合。使您的Postman工作区与您的代码保持同步。

> /postman:sync
Found openapi.yaml in ./api/openapi.yaml
Creating collection "Pet Store API" with 15 endpoints...
Collection synced. Environment "Pet Store - Dev" created.

/postman:codegen --生成客户端代码

从任何Postman集合生成键入的客户端代码。检测您的项目语言并匹配现有约定。

> /postman:codegen
Which collection? "User Management API"
Detected: TypeScript project
Generated: src/clients/user-management-api.ts (5 endpoints, 8 types)

/postman:search --发现API

使用自然语言问题在组织的专用网络、工作区和公共Postman网络中查找API。

> /postman:search
"Is there an endpoint that returns user email addresses?"
Yes -- GET /users/{id} in the "User Management API" collection returns email.

/postman:test --运行收集测试

执行Postman收集测试，分析故障，并获取修复建议。

> /postman:test
Running "Pet Store API" tests...
Passed: 12/15 (80%)
Failed: 3 -- diagnosing...

/postman:mock --创建模拟服务器

从您的集合中创建模拟服务器，用于前端开发和测试。

> /postman:mock
Created mock: https://abc123.mock.pstmn.io
Add to .env: API_BASE_URL=https://abc123.mock.pstmn.io

/postman:docs --API文件

分析文档的完整性，并生成缺失的描述、示例和错误文档。

> /postman:docs
Documentation coverage: 60%
Missing: 12 error responses, 23 parameter descriptions
Want me to fill the gaps?

/postman:security --安全审计

根据OWASP API安全性前10项审核您的API。查找漏洞并提供特定的补救措施。

> /postman:security
Score: 48/100
CRITICAL: 3 endpoints have no auth
HIGH: No rate limiting defined
Providing fixes...

自动布线

你不必记住命令名。该插件包括一个将自然语言映射到正确命令的路由技能：

API准备度分析器

该插件包含一个子代理，用于评估API的AI代理兼容性。它在8个支柱上运行48次检查，并在0-100分制上为您的API打分。

用以下方式触发它：

• “我的API代理准备好了吗？”
• “扫描我的API以了解AI兼容性”
• “我的代理API有什么问题？”

它分析您的OpenAPI规范，识别问题，并引导您完成修复。它可以将改进后的规格推回给Postman。

看 examples/sample-readiness-report.md 用于示例输出。

配置

MCP服务器模式

此插件默认为 代码模式 （~45-50个工具），完全涵盖了8个命令中的7个。唯一的差距是文档发布（仅在完整模式下可用）。

代码模式（默认）：

{
  "mcpServers": {
    "postman": {
      "type": "http",
      "url": "https://mcp.postman.com/mcp",
      "headers": {
        "Authorization": "Bearer ${POSTMAN_API_KEY}"
      }
    }
  }
}

全模式（高级用户，100多种工具）：

编辑 .mcp.json 在插件目录中：

{
  "mcpServers": {
    "postman": {
      "type": "http",
      "url": "https://mcp.postman.com",
      "headers": {
        "Authorization": "Bearer ${POSTMAN_API_KEY}"
      }
    }
  }
}

完整模式包括 publishDocumentation / unpublishDocumentation 但超过了Cursor的80刀具限制。您可能需要在光标设置>MCP中禁用未使用的工具。

环境变量

插件结构

cursor-postman-plugin/
├── .cursor-plugin/
│   └── plugin.json              # Plugin manifest
├── .mcp.json                    # Postman MCP server config (Code mode)
├── commands/
│   ├── setup.md                 # /postman:setup
│   ├── sync.md                  # /postman:sync
│   ├── codegen.md               # /postman:codegen
│   ├── search.md                # /postman:search
│   ├── test.md                  # /postman:test
│   ├── mock.md                  # /postman:mock
│   ├── docs.md                  # /postman:docs
│   └── security.md              # /postman:security
├── skills/
│   ├── postman-routing/         # Auto-routes intent to commands
│   ├── postman-knowledge/       # Postman concepts + MCP guidance
│   └── agent-ready-apis/        # API readiness knowledge
├── agents/
│   └── readiness-analyzer.md    # 48-check API readiness analyzer
├── rules/
│   └── postman-best-practices.mdc  # API design rules
├── assets/                      # Logo and branding
├── examples/
│   └── sample-readiness-report.md
├── LICENSE                      # Apache-2.0
└── README.md

贡献

1. 分叉此存储库
2. 创建要素分支： git checkout -b feature/my-improvement
3. 进行更改
4. 本地测试： /add-plugin /path/to/your/fork
5. 提交拉取请求

添加新命令

1. 创建 commands/your-command.md 使用YAML frontmatter
2. 将路由模式添加到 skills/postman-routing/SKILL.md
3. 测试用 /postman:your-command 在游标中
4. 更新此自述文件

本地测试

# Clone the repo
git clone https://github.com/Postman-Devrel/cursor-postman-plugin.git

# Install in Cursor
# In Cursor agent, run:
/add-plugin /path/to/cursor-postman-plugin

# Verify
/postman:setup

许可证

阿帕奇-2.0

另见

• 克劳德代码的邮递员插件 -所有Postman AI编码插件的真相来源
• 邮递员代理技能 -适用于任何技能的便携式技能.sh兼容代理
• 邮递员光标规则 -游标的轻量级MCP配置+规则

链接

• 邮递员MCP服务器
• 邮差API文件
• 游标插件文档
• Cursor市场 *（即将推出）*