
OpenAI Agents MCP Server

2025.03.15
1
Python代理服务自动化工具开发效率
OpenAI Agents MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,通过 MCP 协议暴露 OpenAI 代理。该服务器提供了多个专门化的代理和一个多代理协调器,用于执行各种任务,如网页搜索、文件搜索和计算机操作等。
View on GitHub
Overview
基本能力
产品定位
OpenAI Agents MCP Server 是一个基于 MCP 协议的服务器,用于暴露 OpenAI 代理,使其可以通过 MCP 协议与客户端(如 Claude 桌面应用)交互。
核心功能
- 专门化代理:
- Web Search Agent:用于实时搜索网页信息。
- File Search Agent:用于搜索和分析 OpenAI 向量存储中的文件。
- Computer Action Agent:用于安全地执行计算机操作。
- 多代理协调器:
- Orchestrator Agent:协调多个专门化代理,选择适合的代理执行任务。
适用场景
- 需要实时网页搜索的场景。
- 需要搜索和分析文件的场景。
- 需要自动化执行计算机操作的场景。
- 需要多个代理协同完成复杂任务的场景。
工具列表
- WebSearchTool:无需参数,可接受可选的位置上下文。
- FileSearchTool:需要
vector_store_ids
(OpenAI 向量存储的 ID)。 - ComputerTool:需要
AsyncComputer
实现(当前为模拟)。
常见问题解答
- 如何配置服务器?通过环境变量
OPENAI_API_KEY
和MCP_TRANSPORT
进行配置。 - 如何测试服务器?使用 MCP Inspector 进行测试。
使用教程
使用依赖
- Python 3.11 或更高版本。
- uv 包管理器(推荐)。
- OpenAI API 密钥。
安装教程
- 通过 Smithery 安装:
bash npx -y @smithery/cli install @lroolle/openai-agents-mcp-server --client claude
- Claude Desktop 配置:
json "mcpServers": { "openai-agents-mcp-server": { "command": "uvx", "args": ["openai-agents-mcp-server"], "env": { "OPENAI_API_KEY": "your-api-key-here" } } }
调试方式
- 运行服务器:
bash export OPENAI_API_KEY=your-api-key export MCP_TRANSPORT=sse uv run mcp dev src/agents_mcp_server/server.py
- 测试服务器:打开浏览器访问
http://localhost:5173
。