
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Postman's MCP server connects AI agents, assistants, and chatbots directly to your APIs on Postman. Use natural language to prompt AI to automate work across your Postman collections, environments, workspaces, and more.
What is an MCP Server?
| Attribute | Details |
|---|---|
| Docker Image | https://hub.docker.com/repository/docker/mcp/postman |
| Author | https://github.com/postmanlabs |
| Repository | https://github.com/postmanlabs/postman-mcp-server |
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/postmanlabs/postman-mcp-server/blob/5aa6aebb07f7e4edf5a5dd4460faba3d9d57ff66/Dockerfile |
| Commit | 5aa6aebb07f7e4edf5a5dd4460faba3d9d57ff66 |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | !Docker Scout Health Score |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/postman --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | Apache License 2.0 |
| Tools provided by this Server | Short Description |
|---|---|
createCollection | Creates a collection using the Postman Collection v2.1.0 schema format. |
createCollectionRequest | Creates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation. |
createCollectionResponse | Creates a request response in a collection. For a complete list of request body properties, refer to the Response entry in the Postman Collection Format documentation. |
createEnvironment | Creates an environment. |
createMock | Creates a mock server in a collection. |
createSpec | Creates an API specification in Postman's Spec Hub. Specifications can be single or multi-file. |
createSpecFile | Creates an API specification file. |
createWorkspace | Creates a new workspace. |
duplicateCollection | Creates a duplicate of the given collection in another workspace. |
generateCollection | Creates a collection from the given API specification. |
generateSpecFromCollection | Generates an API specification for the given collection. The response contains a polling link to the task status. |
getAllSpecs | Gets all API specifications in a workspace. |
getAuthenticatedUser | Gets information about the authenticated user. |
getCollection | Get Collection (map by default) |
getCollections | The workspace ID query is required for this endpoint. If not provided, the LLM should ask the user to provide it. |
getDuplicateCollectionTaskStatus | Gets the status of a collection duplication task. |
getEnabledTools | Get Enabled Tools |
getEnvironment | Gets information about an environment. |
getEnvironments | Gets information about all of your environments. |
getGeneratedCollectionSpecs | Gets the API specification generated for the given collection. |
getMock | Gets information about a mock server. |
getMocks | Gets all active mock servers. By default, returns only mock servers you created across all workspaces. |
getSpec | Gets information about an API specification. |
getSpecCollections | Gets all of an API specification's generated collections. |
getSpecDefinition | Gets the complete contents of an API specification's definition. |
getSpecFile | Gets the contents of an API specification's file. |
getSpecFiles | Gets all the files in an API specification. |
getTaggedEntities | Requires an Enterprise plan. Tagging is only available on Postman Enterprise plans. This tool returns a 404 error on Free, Basic, and Professional accounts. |
getWorkspace | Gets information about a workspace. |
getWorkspaces | Gets all workspaces you have access to. |
publishMock | Publishes a mock server. Publishing a mock server sets its Access Control configuration setting to public. |
putCollection | Replaces the contents of a collection using the Postman Collection v2.1.0 schema format. Include the collection's ID values in the request body. If you do not, the endpoint removes the existing items and creates new items. |
putEnvironment | Replaces all the contents of an environment with the given information. |
runCollection | Run Postman Collection |
syncCollectionWithSpec | Syncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP `202 Accepted` response. |
syncSpecWithCollection | Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP `202 Accepted` response. |
updateCollectionRequest | Updates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation. |
updateMock | Updates a mock server. |
updateSpecFile | Updates an API specification's file. |
updateSpecProperties | Updates an API specification's properties, such as its name. |
updateWorkspace | Updates a workspace's property, such as its name or visibility. |
Tool: createCollection
Creates a collection using the Postman Collection v2.1.0 schema format.
Note:
If you do not include the `workspace` query parameter, the system creates the collection in the oldest personal Internal workspace you own.
| Parameters | Type | Description |
|---|---|---|
workspace | string | The workspace's ID. |
collection | object optional |
Tool: createCollectionRequest
Creates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation.
Note:
It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a request with a blank name.
| Parameters | Type | Description |
|---|---|---|
collectionId | string | The collection's ID. |
auth | string optional | The request's authentication information. |
data | string optional | The request body's form data. |
dataMode | string optional | The request body's data mode. |
dataOptions | string optional | Additional configurations and options set for the request body's various data modes. |
description | string optional | The request's description. |
events | string optional | A list of scripts configured to run when specific events occur. |
folderId | string optional | The folder ID in which to create the request. By default, the system will create the request at the collection level. |
graphqlModeData | string optional | The request body's GraphQL mode data. |
headerData | array optional | The request's headers. |
method | string optional | The request's HTTP method. |
name | string optional | The request's name. It is recommended that you pass the name property in the request body. If you do not, the system uses a null value. As a result, this creates a request with a blank name. |
queryParams | array optional | The request's query parameters. |
rawModeData | string optional | The request body's raw mode data. |
url | string optional | The request's URL. |
Tool: createCollectionResponse
Creates a request response in a collection. For a complete list of request body properties, refer to the Response entry in the Postman Collection Format documentation.
Note:
It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.
| Parameters | Type | Description |
|---|---|---|
collectionId | string | The collection's ID. |
request | string | The parent request's ID. |
cookies | string optional | The response's cookie data. |
dataMode | string optional | The associated request body's data mode. |
dataOptions | string optional | Additional configurations and options set for the request body's various data modes. |
description | string optional | The response's description. |
headers | array optional | A list of headers. |
language | string optional | The response body's language type. |
method | string optional | The request's HTTP method. |
mime | string optional | The response's MIME type. |
name | string optional | The response's name. It is recommended that you pass the name property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name. |
rawDataType | string optional | The response's raw data type. |
rawModeData | string optional | The associated request body's raw mode data. |
requestObject | string optional | A JSON-stringified representation of the associated request. |
responseCode | object optional | The response's HTTP response code information. |
status | string optional | The response's HTTP status text. |
text | string optional | The raw text of the response body. |
time | string optional | The time taken by the request to complete, in milliseconds. |
url | string optional | The associated request's URL. |
Tool: createEnvironment
Creates an environment.
Note:
workspace|string|The workspace's ID.
environment|object optional|Information about the environment.Tool: createMock
Creates a mock server in a collection.
workspace|string|The workspace's ID.
mock|object optional|Tool: createSpec
Creates an API specification in Postman's Spec Hub. Specifications can be single or multi-file.
Note:
files|array|A list of the specification's files and their contents.
name|string|The specification's name.
type|string|The specification's type.
workspaceId|string|The workspace's ID.Tool: createSpecFile
Creates an API specification file.
Note:
content|string|The file's stringified contents.
path|string|The file's path. Accepts JSON or YAML files.
specId|string|The spec's ID.Tool: createWorkspace
Creates a new workspace.
Note:
workspace|object optional|Information about the workspace.Tool: duplicateCollection
Creates a duplicate of the given collection in another workspace.
Use the GET `/collection-duplicate-tasks/{taskId}` endpoint to get the duplication task's current status.
| Parameters | Type | Description |
|---|---|---|
collectionId | string | The collection's unique ID. |
workspace | string | The workspace ID in which to duplicate the collection. |
suffix | string optional | An optional suffix to append to the duplicated collection's name. |
Tool: generateCollection
Creates a collection from the given API specification. The specification must already exist or be created before it can be used to generate a collection. The response contains a polling link to the task status.
| Parameters | Type | Description |
|---|---|---|
elementType | string | The collection element type. |
name | string | The generated collection's name. |
options | object | The advanced creation options and their values. For more details, see Postman's https://github.com/postmanlabs/openapi-to-postman/blob/develop/OPTIONS.md. These properties are case-sensitive. |
specId | string | The spec's ID. |
Tool: generateSpecFromCollection
Generates an API specification for the given collection. The response contains a polling link to the task status.
| Parameters | Type | Description |
|---|---|---|
collectionUid | string | The collection's unique ID. |
elementType | string | The spec value. |
format | string | The format of the API specification. |
name | string | The API specification's name. |
type | string | The specification's type. |
Tool: getAllSpecs
Gets all API specifications in a workspace.
| Parameters | Type | Description |
|---|---|---|
workspaceId | string | The workspace's ID. |
cursor | string optional | The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter. |
limit | integer optional | The maximum number of rows to return in the response. |
This tool is read-only. It does not modify its environment.
Tool: getAuthenticatedUser
Gets information about the authenticated user.
Tool: getCollection
Get information about a collection. By default this tool returns the lightweight collection map (metadata + recursive itemRefs). Use the model parameter to opt in to Postman's full API responses:
collectionId|string|The collection ID must be in the form <OWNER_ID>-access_key|string optional|A collection's read-only access key. Using this query parameter does not require an API key to call the endpoint.
model|string optional|Optional response shape override. Omit to receive the lightweight collection map. Set to minimal for the Postman minimal model or full for the complete collection payload.This tool is read-only. It does not modify its environment.
Tool: getCollections
The workspace ID query is required for this endpoint. If not provided, the LLM should ask the user to provide it.
| Parameters | Type | Description |
|---|---|---|
workspace | string | The workspace's ID. |
limit | integer optional | The maximum number of rows to return in the response. |
name | string optional | Filter results by collections whose name exactly matches the given value. Partial or substring matches are not supported. |
offset | integer optional | The zero-based offset of the first item to return. |
This tool is read-only. It does not modify its environment.
Tool: getDuplicateCollectionTaskStatus
Gets the status of a collection duplication task.
| Parameters | Type | Description |
|---|---|---|
taskId | string | The task's unique ID. |
This tool is read-only. It does not modify its environment.
Tool: getEnabledTools
IMPORTANT: Run this tool first when a requested tool is unavailable. Returns information about which tools are enabled in the full and minimal tool sets, helping you identify available alternatives.
Tool: getEnvironment
Gets information about an environment.
| Parameters | Type | Description |
|---|---|---|
environmentId | string | The environment's ID. |
This tool is read-only. It does not modify its environment.
Tool: getEnvironments
Gets information about all of your environments.
| Parameters | Type | Description |
|---|---|---|
workspace | string optional | The workspace's ID. |
This tool is read-only. It does not modify its environment.
Tool: getGeneratedCollectionSpecs
Gets the API specification generated for the given collection.
| Parameters | Type | Description |
|---|---|---|
collectionUid | string | The collection's unique ID. |
elementType | string | The spec value. |
This tool is read-only. It does not modify its environment.
Tool: getMock
Gets information about a mock server.
mockId|string|The mock's ID.This tool is read-only. It does not modify its environment.
Tool: getMocks
Gets all active mock servers. By default, returns only mock servers you created across all workspaces.
teamId|string optional|Return only results that belong to the given team ID./me (me.teamId).workspace|string optional|Return only results found in the given workspace ID.
This tool is read-only. It does not modify its environment.
Tool: getSpec
Gets information about an API specification.
| Parameters | Type | Description |
|---|---|---|
specId | string | The spec's ID. |
This tool is read-only. It does not modify its environment.
Tool: getSpecCollections
Gets all of an API specification's generated collections.
| Parameters | Type | Description |
|---|---|---|
elementType | string | The collection element type. |
specId | string | The spec's ID. |
cursor | string optional | The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter. |
limit | integer optional | The maximum number of rows to return in the response. |
This tool is read-only. It does not modify its environment.
Tool: getSpecDefinition
Gets the complete contents of an API specification's definition.
| Parameters | Type | Description |
|---|---|---|
specId | string | The spec's ID. |
This tool is read-only. It does not modify its environment.
Tool: getSpecFile
Gets the contents of an API specification's file.
| Parameters | Type | Description |
|---|---|---|
filePath | string | The path to the file. |
specId | string | The spec's ID. |
This tool is read-only. It does not modify its environment.
Tool: getSpecFiles
Gets all the files in an API specification.
| Parameters | Type | Description |
|---|---|---|
specId | string | The spec's ID. |
This tool is read-only. It does not modify its environment.
Tool: getTaggedEntities
Requires an Enterprise plan. Tagging is only available on Postman Enterprise plans. This tool returns a 404 error on Free, Basic, and Professional accounts.
Gets Postman elements (entities) by a given tag. Tags enable you to organize and search workspaces, APIs, and collections that contain shared tags.
| Parameters | Type | Description |
|---|---|---|
slug | string | The tag's ID within a team or individual (non-team) user scope. |
cursor | string optional | The cursor to get the next set of results in the paginated response. If you pass an invalid value, the API only returns the first set of results. |
direction | string optional | The ascending (asc) or descending (desc) order to sort the results by, based on the time of the entity's tagging. |
entityType | string optional | Filter results for the given entity type. |
limit | integer optional | The maximum number of tagged elements to return in a single call. |
This tool is read-only. It does not modify its environment.
Tool: getWorkspace
Gets information about a workspace.
Note:
This endpoint's response contains the `visibility` field. Visibility determines who can access the workspace:
workspaceId|string|The workspace's ID.
include|string optional|Include the following information in the endpoint's response:mocks:deactivated — Include all deactivated mock servers in the response.scim — Return the SCIM user IDs of the workspace creator and who last modified it.This tool is read-only. It does not modify its environment.
Tool: getWorkspaces
Gets all workspaces you have access to.
[...]
以下是 mcp/postman 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务