Servidor MCP de agentes OpenAI

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone agentes OpenAI a través del protocolo MCP.

Características

Este servidor expone tanto agentes individuales como un orquestador de múltiples agentes mediante el SDK de OpenAI Agents:

Agentes Especializados Individuales

• Agente de búsqueda web : un agente especializado para buscar información en tiempo real en la web.

• Agente de búsqueda de archivos : un agente especializado para buscar y analizar archivos en el almacén de vectores de OpenAI

• Computer Action Agent : Un agente especializado para realizar acciones en su computadora de forma segura

Orquestador multiagente

• Agente orquestador : un agente potente que puede coordinar entre los agentes especializados, eligiendo el o los adecuados para cada tarea.

Se accede a cada agente a través del protocolo MCP, lo que lo hace disponible para cualquier cliente MCP, incluida la aplicación de escritorio Claude.

Related MCP server: MCP Simple OpenAI Assistant

Instalación

Prerrequisitos

• Python 3.11 o superior

• Gestor de paquetes uv (recomendado)

• Clave API de OpenAI

Instalación mediante herrería

Para instalar openai-agents-mcp-server para Claude Desktop automáticamente a través de Smithery :

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

Escritorio de Claude

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

Detalles de implementación

Requisitos de herramientas

• WebSearchTool : no se requieren parámetros, pero puede aceptar un contexto de ubicación opcional

• FileSearchTool : Requiere vector_store_ids (ID de sus almacenes de vectores OpenAI)

• ComputerTool : Requiere una implementación de AsyncComputer (actualmente simulada)

Personalización

Puedes personalizar este servidor mediante:

1. Implementación de una interfaz AsyncComputer completa para permitir interacciones informáticas reales

2. Agregar agentes especializados adicionales para otras herramientas OpenAI

3. Mejorar el agente del orquestador para gestionar flujos de trabajo más complejos

Configuración

Puede configurar el servidor utilizando variables de entorno:

• OPENAI_API_KEY : Su clave API de OpenAI (obligatoria)

• MCP_TRANSPORT : Protocolo de transporte a utilizar (predeterminado: "stdio", puede ser "sse")

Desarrollo

Configurar el entorno de desarrollo

# 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

Pruebas con MCP Inspector

Puede probar el servidor utilizando el Inspector MCP:

# 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

Luego abra un navegador web y navegue a http://localhost:5173 .

Licencia

Instituto Tecnológico de Massachusetts (MIT)