邮递员光标规则
您在寻找完整的Cursor插件吗? 看看 游标邮递员插件 获得8条命令、3项技能和一个API就绪度分析器的完整经验。这个仓库提供了一个轻量级的替代方案,只需要MCP配置和一个规则文件。
将这些文件放入任何项目中,为Cursor提供有关Postman工作区和API同步工作流的持久上下文。
包含什么
.cursor/
├── mcp.json # Postman MCP server config
└── rules/
└── postman-mcp.mdc # API sync rules and workflow promptsmcp.json 将Cursor连接到Postman MCP服务器,让您的AI助手直接访问您的Postman收藏、API和工作区。
postman-mcp.mdc 教Cursor何时以及如何与Postman同步代码更改。当您处理API文件(路由、控制器、OpenAPI规范)时,它会自动激活。
设置
1.获取Postman API密钥
去你的 邮差帐户设置 并生成API密钥。
2.设置环境变量
添加到您的shell配置文件(.zshrc, .bashrc等等):
export POSTMAN_API_KEY="PMAK-your-key-here"或者创建一个 .env 项目根目录中的文件:
POSTMAN_API_KEY=PMAK-your-key-here3.将文件复制到您的项目中
# From your project root
cp -r path/to/postman-cursor-rules/.cursor .cursor/或者克隆此仓库并复制 .cursor/ 目录。
4.自定义规则
打开 .cursor/rules/postman-mcp.mdc 并填写您的工作区详细信息:
## Workspace
- Workspace: My API Project
- Workspace ID: 29b66d3d-be33-4dab-b740-2b00f7b5d0b2在Postman中打开工作区时,从URL获取工作区ID: https://go.postman.co/workspace/
5.重新启动游标
重新启动Cursor以获取新的MCP服务器和规则。您应该在Cursor设置中的MCP服务器下看到“邮递员”列表。
MCP服务器模式
默认配置使用 /code 模式。您可以在中更改URL mcp.json 根据您的需求:
| 模式 | URL | 用例 |
|---|---|---|
| 最小 | https://mcp.postman.com/minimal | 基本收款操作 |
| 代码 | https://mcp.postman.com/code | API搜索+客户端代码生成 |
| 满 | https://mcp.postman.com/mcp | 一切(100多种Postman API工具) |
运作原理
规则文件使用Cursor的 应用于特定文件 模式。当您打开与API模式匹配的文件时,它会自动激活:
**/api/**/***/routes/**/*,**/routers/**/***/endpoints/**/*,**/controllers/**/*openapi.yaml,openapi.json,swagger.yaml,swagger.json
一旦激活,Cursor就知道如何将代码更改与Postman同步。要求它添加端点,检查代码和规范之间的偏差,或从API生成客户端代码。
示例提示
设置后,在Cursor中尝试以下操作:
“使用示例响应将新的GET/users/{id}/orders端点添加到我的Postman集合中。”
“从Postman工作区获取API规范,并将其与本地架构进行比较。有什么不同步?”
“我刚刚添加了3个新端点。请将所有端点与适当的文档同步到Postman。”
“从Postman工作区中的用户API生成TypeScript客户端。”
资源
另见
- 游标邮递员插件 -包含命令、技能和代理的完整插件
- 克劳德代码的邮递员插件 -所有Postman AI编码插件的真相来源
- 邮递员代理技能 -适用于任何技能的便携式技能.sh兼容代理
