What is Openai Agents Mcp Server

openai-agents-mcp-server is a Model Context Protocol (MCP) server that exposes OpenAI agents through the MCP protocol, allowing users to interact with specialized agents for various tasks.

Use cases

Use cases include real-time web searches, file analysis in vector stores, and executing safe actions on computers, making it suitable for developers, researchers, and tech enthusiasts.

How to use

To use openai-agents-mcp-server, install it via Smithery with the command: npx -y @smithery/cli install @lroolle/openai-agents-mcp-server --client claude. Configure it with your OpenAI API key and run the server to access the agents.

Key features

Key features include individual specialized agents like Web Search Agent, File Search Agent, and Computer Action Agent, as well as a Multi-Agent Orchestrator that coordinates tasks among these agents.

Where to use

openai-agents-mcp-server can be used in various fields such as software development, data analysis, and automation tasks, where interaction with AI agents is beneficial.

OpenAI Agents MCP Server

A Model Context Protocol (MCP) server that exposes OpenAI agents through the MCP protocol.

Features

This server exposes both individual agents and a multi-agent orchestrator using the OpenAI Agents SDK:

Individual Specialized Agents

• Web Search Agent: A specialized agent for searching the web for real-time information
• File Search Agent: A specialized agent for searching and analyzing files in OpenAI’s vector store
• Computer Action Agent: A specialized agent for performing actions on your computer safely

Multi-Agent Orchestrator

• Orchestrator Agent: A powerful agent that can coordinate between the specialized agents, choosing the right one(s) for each task

Each agent is accessed through the MCP protocol, making them available to any MCP client, including the Claude desktop app.

Installation

Prerequisites

• Python 3.11 or higher
• uv package manager (recommended)
• OpenAI API key

Installing via Smithery

To install openai-agents-mcp-server for Claude Desktop automatically via Smithery:

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

Claude Desktop

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

Implementation Details

Tool Requirements

• WebSearchTool: No required parameters, but can accept optional location context
• FileSearchTool: Requires vector_store_ids (IDs from your OpenAI vector stores)
• ComputerTool: Requires an AsyncComputer implementation (currently simulated)

Customization

You can customize this server by:

1. Implementing a full AsyncComputer interface to enable real computer interactions
2. Adding additional specialized agents for other OpenAI tools
3. Enhancing the orchestrator agent to handle more complex workflows

Configuration

You can configure the server using environment variables:

• OPENAI_API_KEY: Your OpenAI API key (required)
• MCP_TRANSPORT: Transport protocol to use (default: “stdio”, can be “sse”)

Development

Setup development environment

# 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

Testing with MCP Inspector

You can test the server using the 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

Then open a web browser and navigate to http://localhost:5173.

License

MIT