About Openai Agents MCP Server
Openai Agents MCP Server is an MCP server published by lroolle in the AI category: openAI Agents And Tools as MCP Server.
The repository has 10 stars and 5 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/lroolle/openai-agents-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Openai Agents MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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:
- Implementing a full AsyncComputer interface to enable real computer interactions
- Adding additional specialized agents for other OpenAI tools
- 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
README fetched from the repository yesterday. The original is authoritative.