Openai Agents

🚀 OpenAI 代理 MCP 服务端

这是一个通过 MCP 协议暴露 OpenAI 代理的服务端，能提供单个 OpenAI 代理和多代理协调器，为用户提供便捷的代理服务。

🚀 快速开始

此服务端既提供单个 OpenAI 代理，也提供一个多代理协调器，均使用 OpenAI 的_agents SDK_，每个代理均可通过 MCP 协议访问，可供任何 MCP 客户端使用，包括 Claude 桌面应用。

✨ 主要特性

专门的单一代理

• 网络搜索代理：用于实时信息查询的专用代理
• 文件搜索代理：用于在 OpenAI 向量存储中搜索和分析文件
• 计算机操作代理：用于安全地执行计算机操作的专用代理

多代理协调器

• 协调器代理：一个强大的代理，能够协调各个专门代理，选择最适合完成任务的代理（或多个代理）

📦 安装指南

先决条件

• Python 3.11 或更高版本
• uv 包管理器（推荐）
• OpenAI API 密钥

通过 Smithery 安装

要自动通过 Smithery 安装 openai-agents-mcp-server：

npx -y @smithery/cli install @lroolle/openai-agents-mcp-server --client claude

Claude 桌面版

在 config.json 中添加以下内容以配置 Claude 桌面版：

"mcpServers": {
  "openai-agents-mcp-server": {
    "command": "uvx",
    "args": ["openai-agents-mcp-server"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
}

🔧 技术细节

工具要求

• WebSearchTool：无需参数，但可接受上下文位置
• FileSearchTool：需要 vector_store_ids（来自 OpenAI 向量存储的 ID）
• ComputerTool：需要一个完整的 AsyncComputer 接口实现（目前为模拟版本）

自定义

可通过以下方式自定义此服务端：

1. 实现一个完整的 AsyncComputer 接口，以启用真实计算机交互
2. 添加其他 OpenAI 工具的专用代理
3. 增强协调器代理的功能，处理更复杂的流程

📚 详细文档

配置

可使用环境变量配置服务端：

• OPENAI_API_KEY：你的 OpenAI API 密钥（必需）
• MCP_TRANSPORT：使用的传输协议，默认为 "stdio"，可选 "sse"

开发

设置开发环境

# 克隆仓库
git clone https://github.com/lroolle/openai-agents-mcp-server.git
cd openai-agents-mcp-server

# 创建虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装依赖项
uv sync --dev

使用 MCP 检查器测试

可通过以下步骤使用 MCP 检查器进行测试：

# 在一个终端窗口中，以 SSE 传输运行服务端
export OPENAI_API_KEY=your-api-key
export MCP_TRANSPORT=sse

uv run mcp dev src/agents_mcp_server/server.py

然后在浏览器中打开 http://localhost:5173。

📄 许可证

MIT