Skip to content

ADK 的 Postman MCP 工具

Supported in ADKPythonTypeScript

Postman MCP 服务器 将你的 ADK 智能体连接到 Postman 生态系统。此集成赋予你的智能体访问工作区、管理集合和环境、评估 API 以及通过自然语言交互自动化工作流的能力。

使用场景

  • API 测试：使用 Postman 集合持续测试你的 API。

  • 集合管理：无需离开编辑器即可创建和标记集合、更新文档、添加评论或跨多个集合执行操作。

  • 工作区和环境管理：创建工作区和环境，并管理你的环境变量。

  • 客户端代码生成：生成符合最佳实践和项目约定的生产级客户端代码以使用 API。

前置条件

与智能体一起使用

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="postman_agent",
    instruction="Help users manage their Postman workspaces and collections",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "@postman/postman-mcp-server",
                        # "--full",  # Use all 100+ tools
                        # "--code",  # Use code generation tools
                        # "--region", "eu",  # Use EU region
                    ],
                    env={
                        "POSTMAN_API_KEY": POSTMAN_API_KEY,
                    },
                ),
                timeout=30,
            ),
        )
    ],
)

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="postman_agent",
    instruction="Help users manage their Postman workspaces and collections",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url="https://mcp.postman.com/mcp",
                # (Optional) Use "/minimal" for essential tools only
                # (Optional) Use "/code" for code generation tools
                # (Optional) Use "https://mcp.eu.postman.com" for EU region
                headers={
                    "Authorization": f"Bearer {POSTMAN_API_KEY}",
                },
            ),
        )
    ],
)

import { LlmAgent, MCPToolset } from "@google/adk";

const POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "postman_agent",
    instruction: "Help users manage their Postman workspaces and collections",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: [
                    "-y",
                    "@postman/postman-mcp-server",
                    // "--full",  // Use all 100+ tools
                    // "--code",  // Use code generation tools
                    // "--region", "eu",  // Use EU region
                ],
                env: {
                    POSTMAN_API_KEY: POSTMAN_API_KEY,
                },
            },
        }),
    ],
});

export { rootAgent };

import { LlmAgent, MCPToolset } from "@google/adk";

const POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "postman_agent",
    instruction: "Help users manage their Postman workspaces and collections",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.postman.com/mcp",
            // (Optional) Use "/minimal" for essential tools only
            // (Optional) Use "/code" for code generation tools
            // (Optional) Use "https://mcp.eu.postman.com" for EU region
            header: {
                Authorization: `Bearer ${POSTMAN_API_KEY}`,
            },
        }),
    ],
});

export { rootAgent };

配置

Postman 提供三种工具配置：

  • Minimal (默认)：用于基本 Postman 操作的基本工具。最适合对集合、工作区或环境进行简单的修改。
  • Full：所有可用的 Postman API 工具（100+ 个工具）。非常适合高级协作和企业功能。
  • Code：用于搜索 API 定义和生成客户端代码的工具。非常适合需要使用 API 的开发人员。

要选择配置：

  • 本地服务器：将 --full 或 --code 添加到 args 列表中。
  • 远程服务器：将 URL 路径更改为 /minimal、/mcp (full) 或 /code。

对于欧盟区域，使用 --region eu (本地) 或 https://mcp.eu.postman.com (远程)。

额外资源