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