OpenAI 에이전트 MCP 서버

MCP 프로토콜을 통해 OpenAI 에이전트를 노출하는 MCP(Model Context Protocol) 서버입니다.

특징

이 서버는 OpenAI Agents SDK를 사용하여 개별 에이전트와 다중 에이전트 오케스트레이터를 모두 노출합니다.

개별 전문 에이전트

웹 검색 에이전트 : 웹에서 실시간 정보를 검색하는 전문 에이전트
파일 검색 에이전트 : OpenAI 벡터 저장소에서 파일을 검색하고 분석하기 위한 전문 에이전트
컴퓨터 액션 에이전트 : 컴퓨터에서 안전하게 작업을 수행하기 위한 전문 에이전트

다중 에이전트 오케스트레이터

오케스트레이터 에이전트 : 전문화된 에이전트들 사이에서 조정이 가능하고 각 작업에 적합한 에이전트를 선택할 수 있는 강력한 에이전트입니다.

각 에이전트는 MCP 프로토콜을 통해 접근하므로 Claude 데스크톱 앱을 포함한 모든 MCP 클라이언트에서 사용할 수 있습니다.

설치

필수 조건

Python 3.11 이상
uv 패키지 관리자(추천)
OpenAI API 키

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 openai-agents-mcp-server를 자동으로 설치하려면:

지엑스피1

클로드 데스크탑

"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 구현이 필요합니다(현재 시뮬레이션됨)

사용자 정의

다음을 통해 이 서버를 사용자 지정할 수 있습니다.

실제 컴퓨터 상호 작용을 가능하게 하는 전체 AsyncComputer 인터페이스 구현
다른 OpenAI 도구에 대한 추가 전문 에이전트 추가
더욱 복잡한 워크플로를 처리하기 위해 오케스트레이터 에이전트 향상

구성

환경 변수를 사용하여 서버를 구성할 수 있습니다.

OPENAI_API_KEY : OpenAI API 키(필수)
MCP_TRANSPORT : 사용할 전송 프로토콜(기본값: "stdio", "sse" 가능)

개발

개발 환경 설정

# Clone the repository
git clone https://github.com/lroolle/openai-agents-mcp-server.git
cd openai-agents-mcp-server

# Create a virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv sync --dev

MCP Inspector로 테스트

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

# In one terminal, run the server with SSE transport
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

OpenAI Agents MCP Server

Integrations