返回博客2025年3月27日

OpenAI Agents SDK 支持 MCP 极简指南

OpenAIMCPAgents SDK

OpenAI Agents SDK 支持 MCP 极简指南

OpenAI Agents SDK 现已支持 MCP!这意味着我们可以更轻松地让 AI 使用各种外部工具了。

MCP 是什么?

MCP(模型上下文协议)就像 AI 的 USB 接口,让 AI 能标准化地连接各种工具和数据源。

两种服务器类型

  • stdio 服务器:本地运行,作为子进程
  • HTTP over SSE 服务器:远程运行,通过 URL 连接

基本用法

# 连接文件系统服务器
async with MCPServerStdio(
    params={
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", samples_dir],
    },
) as server:
    tools = await server.list_tools()

# 添加到 Agent
agent = Agent(
    name="Assistant",
    instructions="使用工具完成任务",
    mcp_servers=[server]
)

缓存技巧

如果工具列表不会变,可以启用缓存减少延迟:

MCPServerSse(..., cache_tools_list=True)

跟踪功能

SDK 会自动跟踪 MCP 操作,包括工具列表获取和工具调用,方便调试。

总结

OpenAI Agents SDK 对 MCP 的支持让 AI 应用能力大大增强,值得一试!

完整文档

准备开始了吗?

先简单说明目标,我会给出最合适的沟通方式。