[{"_1":2,"_318":-5,"_319":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_259":260},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_65":-5,"_66":28,"_29":67,"_176":177,"_258":121},"availableLocales",[28,40,47,53,59],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","A lightweight bridge that wraps OpenAI's built-in tools (like web search and code interpreter) as Model Context Protocol servers, enabling their use with Claude and other MCP-compatible models.","name","openai-tool2mcp","readme","# openai-tool2mcp\n\n[![Release](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)\n[![Build status](https://img.shields.io/github/actions/workflow/status/alohays/openai-tool2mcp/main.yml?branch=main)](https://github.com/alohays/openai-tool2mcp/actions/workflows/main.yml?query=branch%3Amain)\n[![codecov](https://codecov.io/gh/alohays/openai-tool2mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/alohays/openai-tool2mcp)\n[![Commit activity](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp)](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp)\n[![License](https://img.shields.io/github/license/alohays/openai-tool2mcp)](https://img.shields.io/github/license/alohays/openai-tool2mcp)\n\n**openai-tool2mcp** is a lightweight, open-source bridge that wraps OpenAI's powerful built-in tools as Model Context Protocol (MCP) servers. It enables you to use high-quality OpenAI tools like web search and code interpreter with Claude and other MCP-compatible models.\n\n- 🔍 **Use OpenAI's robust web search in Claude App**\n- 💻 **Access code interpreter functionality in any MCP-compatible LLM**\n- 🔄 **Seamless protocol translation between OpenAI and MCP**\n- 🛠️ **Simple API for easy integration**\n- 🌐 **Full compatibility with the MCP SDK**\n\n## 🔍 OpenAI Search Integration Demo with Claude App! 🚀\n\nhttps://github.com/user-attachments/assets/f1f10e2c-b995-4e03-8b28-61eeb2b2bfe9\n\nOpenAI tried to keep their powerful, LLM-optimized tools locked within their own agent platform, but they couldn't stop the unstoppable open-source movement of MCP!\n\n## The Developer's Dilemma\n\nAI developers currently face a challenging choice between two ecosystems:\n\n```mermaid\ngraph TD\n subgraph \"Developer's Dilemma\"\n style Developer fill:#ff9e64,stroke:#fff,stroke-width:2px\n Developer((Developer))\n end\n\n subgraph \"OpenAI's Ecosystem\"\n style OpenAITools fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Tracing fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Evaluation fill:#bb9af7,stroke:#fff,stroke-width:2px\n style VendorLock fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n OpenAITools[\"Built-in Tools
(Web Search, Code Interpreter)\"]\n Tracing[\"Advanced Tracing
(Visual Debugging)\"]\n Evaluation[\"Evaluation Dashboards
(Performance Metrics)\"]\n VendorLock[\"Vendor Lock-in
⚠️ Closed Source ⚠️\"]\n\n OpenAITools --> Tracing\n Tracing --> Evaluation\n OpenAITools -.-> VendorLock\n Tracing -.-> VendorLock\n Evaluation -.-> VendorLock\n end\n\n subgraph \"MCP Ecosystem\"\n style MCPStandard fill:#7dcfff,stroke:#fff,stroke-width:2px\n style MCPTools fill:#7dcfff,stroke:#fff,stroke-width:2px\n style OpenStandard fill:#9ece6a,stroke:#fff,stroke-width:2px\n style LimitedTools fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n MCPStandard[\"Model Context Protocol
(Open Standard)\"]\n MCPTools[\"MCP-compatible Tools\"]\n OpenStandard[\"Open Ecosystem
✅ Interoperability ✅\"]\n LimitedTools[\"Limited Tool Quality
⚠️ Less Mature (e.g., web search, computer use) ⚠️\"]\n\n MCPStandard --> MCPTools\n MCPStandard --> OpenStandard\n MCPTools -.-> LimitedTools\n end\n\n Developer -->|\"Wants powerful tools
& visualizations\"| OpenAITools\n Developer -->|\"Wants open standards
& interoperability\"| MCPStandard\n\n classDef highlight fill:#ff9e64,stroke:#fff,stroke-width:4px;\n class Developer highlight\n```\n\n**openai-tool2mcp** bridges this gap by letting you use OpenAI's mature, high-quality tools within the open MCP ecosystem.\n\n## 🌟 Features\n\n- **Easy Setup**: Get up and running with a few simple commands\n- **OpenAI Tools as MCP Servers**: Wrap powerful OpenAI built-in tools as MCP-compliant servers\n- **Seamless Integration**: Works with Claude App and other MCP-compatible clients\n- **MCP SDK Compatible**: Uses the official MCP Python SDK\n- **Tool Support**:\n - 🔍 Web Search\n - 💻 Code Interpreter\n - 🌐 Web Browser\n - 📁 File Management\n- **Open Source**: MIT licensed, hackable and extensible\n\n## 🚀 Installation\n\n```bash\n# Install from PyPI\npip install openai-tool2mcp\n\n# Or install the latest development version\npip install git+https://github.com/alohays/openai-tool2mcp.git\n\n# Recommended: Install uv for better MCP compatibility\npip install uv\n```\n\n### Prerequisites\n\n- Python 3.10+\n- OpenAI API key with access to the Assistant API\n- (Recommended) uv package manager for MCP compatibility\n\n## 🛠️ Quick Start\n\n1. **Set your OpenAI API key**:\n\n```bash\nexport OPENAI_API_KEY=\"your-api-key-here\"\n```\n\n2. **Start the MCP server with OpenAI tools**:\n\n```bash\n# Recommended: Use uv for MCP compatibility (recommended by MCP documentation)\nuv run openai_tool2mcp/server_entry.py --transport stdio\n\n# Or use the traditional method with the CLI\nopenai-tool2mcp start --transport stdio\n```\n\n3. **Use with Claude for Desktop**:\n\nConfigure your Claude for Desktop to use the server by editing the claude_desktop_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/openai-tool2mcp\",\n \"run\",\n \"openai_tool2mcp/server_entry.py\"\n ]\n }\n }\n}\n```\n\nThe config file is located at:\n\n- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 💻 Usage Examples\n\n### Basic Server Configuration\n\n```python\n# server_script.py\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Configure with OpenAI web search\nconfig = ServerConfig(\n openai_api_key=\"your-api-key\",\n tools=[OpenAIBuiltInTools.WEB_SEARCH.value]\n)\n\n# Create and start server with STDIO transport (for MCP compatibility)\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nRun it with `uv` as recommended by MCP:\n\n```bash\nuv run server_script.py\n```\n\n### MCP-Compatible Configuration for Claude Desktop\n\nCreate a standalone script:\n\n```python\n# openai_tools_server.py\nimport os\nfrom dotenv import load_dotenv\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Load environment variables\nload_dotenv()\n\n# Create a server with multiple tools\nconfig = ServerConfig(\n openai_api_key=os.environ.get(\"OPENAI_API_KEY\"),\n tools=[\n OpenAIBuiltInTools.WEB_SEARCH.value,\n OpenAIBuiltInTools.CODE_INTERPRETER.value\n ]\n)\n\n# Create and start the server with stdio transport for MCP compatibility\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nConfigure Claude Desktop to use this script with `uv`:\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/project/folder\",\n \"run\",\n \"openai_tools_server.py\"\n ]\n }\n }\n}\n```\n\n## 📊 How It Works\n\nThe library serves as a bridge between the OpenAI Assistant API and the MCP protocol:\n\n```mermaid\nsequenceDiagram\n participant Claude as \"Claude App\"\n participant MCP as \"MCP Client\"\n participant Server as \"openai-tool2mcp Server\"\n participant OpenAI as \"OpenAI API\"\n\n Claude->>MCP: User query requiring tools\n MCP->>Server: MCP request\n Server->>OpenAI: Convert to OpenAI format\n OpenAI->>Server: Tool response\n Server->>MCP: Convert to MCP format\n MCP->>Claude: Display result\n```\n\n## 🔄 MCP SDK Integration\n\n`openai-tool2mcp` is now fully compatible with the MCP SDK. You can use it with the Claude for Desktop app by:\n\n1. Installing the package with `pip install openai-tool2mcp`\n2. Configuring your `claude_desktop_config.json` to include:\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"openai-tool2mcp\",\n \"args\": [\n \"start\",\n \"--transport\",\n \"stdio\",\n \"--tools\",\n \"retrieval\",\n \"code_interpreter\"\n ]\n }\n }\n}\n```\n\nThe config file is located at:\n\n- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Here's how you can help:\n\n1. **Fork** the repository\n2. **Clone** your fork to your local machine\n3. **Create a branch** for your feature or bugfix\n4. **Make your changes** and commit them\n5. **Push** to your fork and submit a **pull request**\n\nPlease make sure to follow our coding standards and add tests for any new features.\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/alohays/openai-tool2mcp.git\ncd openai-tool2mcp\n\n# Install in development mode\nmake install\n\n# Run tests\nmake test\n\n# Run linting\nmake lint\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n- The OpenAI team for their excellent tools and APIs\n- The MCP community for developing an open standard for tool usage\n- All contributors who have helped improve this project\n\n---\n\n## ⚠️ Project Status\n\nThis project is in active development. While the core functionality works, expect frequent updates and improvements. If you encounter any issues, please submit them on our [issue tracker](https://github.com/alohays/openai-tool2mcp/issues).\n\n---\n\n_openai-tool2mcp is part of the broader [MCPortal](https://github.com/alohays/mcportal) initiative to bridge OpenAI's tools with the open-source MCP ecosystem._\n","English","tag","en-US",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Un puente liviano que envuelve las herramientas integradas de OpenAI (como la búsqueda web y el intérprete de código) como servidores de Protocolo de Contexto de Modelo, lo que permite su uso con Claude y otros modelos compatibles con MCP.","herramienta openai-tool2mcp","# herramienta openai-tool2mcp\n\n[![Liberar](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)[![Estado de compilación](https://img.shields.io/github/actions/workflow/status/alohays/openai-tool2mcp/main.yml?branch=main)](https://github.com/alohays/openai-tool2mcp/actions/workflows/main.yml?query=branch%3Amain) [![código decodificador](https://codecov.io/gh/alohays/openai-tool2mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/alohays/openai-tool2mcp) [![Actividad de confirmación](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp)](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp) [![Licencia](https://img.shields.io/github/license/alohays/openai-tool2mcp)](https://img.shields.io/github/license/alohays/openai-tool2mcp)\n\n**openai-tool2mcp** es un puente ligero y de código abierto que integra las potentes herramientas integradas de OpenAI como servidores del Protocolo de Contexto de Modelo (MCP). Permite utilizar herramientas OpenAI de alta calidad, como la búsqueda web y el intérprete de código, con Claude y otros modelos compatibles con MCP.\n\n* 🔍 **Utilice la robusta búsqueda web de OpenAI en la aplicación Claude**\n* 💻 **Funcionalidad de intérprete de código de acceso en cualquier LLM compatible con MCP**\n* 🔄 **Traducción de protocolos fluida entre OpenAI y MCP**\n* 🛠️ **API sencilla para una fácil integración**\n* 🌐 **Compatibilidad total con el SDK de MCP**\n\n## ¡Demostración de la integración de OpenAI Search con la aplicación Claude! 🚀\n\n\n\nOpenAI intentó mantener sus poderosas herramientas optimizadas para LLM bloqueadas dentro de su propia plataforma de agentes, ¡pero no pudo detener el imparable movimiento de código abierto de MCP!\n\n## El dilema del desarrollador\n\nLos desarrolladores de IA se enfrentan actualmente a una difícil elección entre dos ecosistemas:\n\n```mermaid\ngraph TD\n subgraph \"Developer's Dilemma\"\n style Developer fill:#ff9e64,stroke:#fff,stroke-width:2px\n Developer((Developer))\n end\n\n subgraph \"OpenAI's Ecosystem\"\n style OpenAITools fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Tracing fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Evaluation fill:#bb9af7,stroke:#fff,stroke-width:2px\n style VendorLock fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n OpenAITools[\"Built-in Tools
(Web Search, Code Interpreter)\"]\n Tracing[\"Advanced Tracing
(Visual Debugging)\"]\n Evaluation[\"Evaluation Dashboards
(Performance Metrics)\"]\n VendorLock[\"Vendor Lock-in
⚠️ Closed Source ⚠️\"]\n\n OpenAITools --> Tracing\n Tracing --> Evaluation\n OpenAITools -.-> VendorLock\n Tracing -.-> VendorLock\n Evaluation -.-> VendorLock\n end\n\n subgraph \"MCP Ecosystem\"\n style MCPStandard fill:#7dcfff,stroke:#fff,stroke-width:2px\n style MCPTools fill:#7dcfff,stroke:#fff,stroke-width:2px\n style OpenStandard fill:#9ece6a,stroke:#fff,stroke-width:2px\n style LimitedTools fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n MCPStandard[\"Model Context Protocol
(Open Standard)\"]\n MCPTools[\"MCP-compatible Tools\"]\n OpenStandard[\"Open Ecosystem
✅ Interoperability ✅\"]\n LimitedTools[\"Limited Tool Quality
⚠️ Less Mature (e.g., web search, computer use) ⚠️\"]\n\n MCPStandard --> MCPTools\n MCPStandard --> OpenStandard\n MCPTools -.-> LimitedTools\n end\n\n Developer -->|\"Wants powerful tools
& visualizations\"| OpenAITools\n Developer -->|\"Wants open standards
& interoperability\"| MCPStandard\n\n classDef highlight fill:#ff9e64,stroke:#fff,stroke-width:4px;\n class Developer highlight\n```\n\n**openai-tool2mcp** cierra esta brecha al permitirle utilizar las herramientas maduras y de alta calidad de OpenAI dentro del ecosistema MCP abierto.\n\n## 🌟 Características\n\n* **Configuración sencilla** : comience a funcionar con unos pocos comandos simples\n* **Herramientas OpenAI como servidores MCP** : integre las potentes herramientas integradas de OpenAI como servidores compatibles con MCP\n* **Integración perfecta** : funciona con Claude App y otros clientes compatibles con MCP\n* **Compatible con MCP SDK** : utiliza el SDK oficial de MCP Python\n* **Soporte de herramientas** :\n * 🔍 Búsqueda web\n * 💻 Intérprete de código\n * 🌐 Navegador web\n * 📁 Gestión de archivos\n* **Código abierto** : con licencia MIT, pirateable y extensible\n\n## 🚀 Instalación\n\n```bash\n# Install from PyPI\npip install openai-tool2mcp\n\n# Or install the latest development version\npip install git+https://github.com/alohays/openai-tool2mcp.git\n\n# Recommended: Install uv for better MCP compatibility\npip install uv\n```\n\n### Prerrequisitos\n\n* Python 3.10+\n* Clave API de OpenAI con acceso a la API del Asistente\n* (Recomendado) Gestor de paquetes uv para compatibilidad con MCP\n\n## 🛠️ Inicio rápido\n\n1. **Establezca su clave API de OpenAI** :\n\n```bash\nexport OPENAI_API_KEY=\"your-api-key-here\"\n```\n\n2. **Inicie el servidor MCP con las herramientas OpenAI** :\n\n```bash\n# Recommended: Use uv for MCP compatibility (recommended by MCP documentation)\nuv run openai_tool2mcp/server_entry.py --transport stdio\n\n# Or use the traditional method with the CLI\nopenai-tool2mcp start --transport stdio\n```\n\n3. **Usar con Claude para escritorio** :\n\nConfigure su Claude for Desktop para usar el servidor editando claude\\_desktop\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/openai-tool2mcp\",\n \"run\",\n \"openai_tool2mcp/server_entry.py\"\n ]\n }\n }\n}\n```\n\nEl archivo de configuración se encuentra en:\n\n* MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n* Ventanas: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 💻 Ejemplos de uso\n\n### Configuración básica del servidor\n\n```python\n# server_script.py\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Configure with OpenAI web search\nconfig = ServerConfig(\n openai_api_key=\"your-api-key\",\n tools=[OpenAIBuiltInTools.WEB_SEARCH.value]\n)\n\n# Create and start server with STDIO transport (for MCP compatibility)\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nEjecútelo con `uv` según lo recomendado por MCP:\n\n```bash\nuv run server_script.py\n```\n\n### Configuración compatible con MCP para Claude Desktop\n\nCrear un script independiente:\n\n```python\n# openai_tools_server.py\nimport os\nfrom dotenv import load_dotenv\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Load environment variables\nload_dotenv()\n\n# Create a server with multiple tools\nconfig = ServerConfig(\n openai_api_key=os.environ.get(\"OPENAI_API_KEY\"),\n tools=[\n OpenAIBuiltInTools.WEB_SEARCH.value,\n OpenAIBuiltInTools.CODE_INTERPRETER.value\n ]\n)\n\n# Create and start the server with stdio transport for MCP compatibility\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nConfigurar Claude Desktop para usar este script con `uv` :\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/project/folder\",\n \"run\",\n \"openai_tools_server.py\"\n ]\n }\n }\n}\n```\n\n## 📊 Cómo funciona\n\nLa biblioteca actúa como puente entre la API de OpenAI Assistant y el protocolo MCP:\n\n```mermaid\nsequenceDiagram\n participant Claude as \"Claude App\"\n participant MCP as \"MCP Client\"\n participant Server as \"openai-tool2mcp Server\"\n participant OpenAI as \"OpenAI API\"\n\n Claude->>MCP: User query requiring tools\n MCP->>Server: MCP request\n Server->>OpenAI: Convert to OpenAI format\n OpenAI->>Server: Tool response\n Server->>MCP: Convert to MCP format\n MCP->>Claude: Display result\n```\n\n## 🔄 Integración del SDK de MCP\n\n`openai-tool2mcp` ahora es totalmente compatible con el SDK de MCP. Puedes usarlo con la aplicación Claude para escritorio:\n\n1. Instalación del paquete con `pip install openai-tool2mcp`\n2. Configurar su `claude_desktop_config.json` para incluir:\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"openai-tool2mcp\",\n \"args\": [\n \"start\",\n \"--transport\",\n \"stdio\",\n \"--tools\",\n \"retrieval\",\n \"code_interpreter\"\n ]\n }\n }\n}\n```\n\nEl archivo de configuración se encuentra en:\n\n* MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n* Ventanas: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 🤝 Contribuyendo\n\n¡Agradecemos las contribuciones de la comunidad! Puedes ayudar de esta manera:\n\n1. **Bifurcar** el repositorio\n2. **Clona** tu bifurcación en tu máquina local\n3. **Crea una rama** para tu característica o corrección de errores\n4. **Realice sus cambios** y confirme\n5. **Empujar** a su bifurcación y enviar una **solicitud de extracción**\n\nAsegúrese de seguir nuestros estándares de codificación y agregar pruebas para cualquier característica nueva.\n\n### Configuración de desarrollo\n\n```bash\n# Clone the repository\ngit clone https://github.com/alohays/openai-tool2mcp.git\ncd openai-tool2mcp\n\n# Install in development mode\nmake install\n\n# Run tests\nmake test\n\n# Run linting\nmake lint\n```\n\n## 📄 Licencia\n\nEste proyecto está licenciado bajo la licencia MIT: consulte el archivo [de LICENCIA](LICENSE) para obtener más detalles.\n\n## 🙏 Agradecimientos\n\n* Al equipo de OpenAI por sus excelentes herramientas y API\n* La comunidad MCP para desarrollar un estándar abierto para el uso de herramientas\n* Todos los colaboradores que han ayudado a mejorar este proyecto\n\n***\n\n## ⚠️ Estado del proyecto\n\nEste proyecto está en desarrollo activo. Mientras la funcionalidad principal funcione, se esperan actualizaciones y mejoras frecuentes. Si encuentra algún problema, por favor, infórmenos en nuestro [sistema de seguimiento de problemas](https://github.com/alohays/openai-tool2mcp/issues) .\n\n***\n\n*openai-tool2mcp es parte de la iniciativa más amplia [MCPortal](https://github.com/alohays/mcportal) para unir las herramientas de OpenAI con el ecosistema MCP de código abierto.*","Spanish","es-ES",{"_29":48,"_33":51,"_38":52},{"_31":49,"_33":34,"_35":50},"OpenAI の組み込みツール (Web 検索やコードインタープリターなど) をモデルコンテキストプロトコルサーバーとしてラップし、Claude やその他の MCP 互換モデルで使用できるようにする軽量ブリッジです。","# openai-tool2mcp\n\n[![リリース](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)[![ビルドステータス](https://img.shields.io/github/actions/workflow/status/alohays/openai-tool2mcp/main.yml?branch=main)](https://github.com/alohays/openai-tool2mcp/actions/workflows/main.yml?query=branch%3Amain) [![コードコフ](https://codecov.io/gh/alohays/openai-tool2mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/alohays/openai-tool2mcp) [![コミットアクティビティ](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp)](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp) [![ライセンス](https://img.shields.io/github/license/alohays/openai-tool2mcp)](https://img.shields.io/github/license/alohays/openai-tool2mcp)\n\n**openai-tool2mcpは、** OpenAIの強力な組み込みツールをModel Context Protocol（MCP）サーバーとしてラップする、軽量なオープンソースブリッジです。これにより、Web検索やコードインタープリターなどの高品質なOpenAIツールを、Claudeやその他のMCP互換モデルで利用できるようになります。\n\n* 🔍 **Claude アプリで OpenAI の堅牢なウェブ検索を使用する**\n* 💻 **MCP 互換の LLM でコードインタープリタ機能にアクセス**\n* 🔄 **OpenAIとMCP間のシームレスなプロトコル変換**\n* 🛠️**シンプルなAPIで簡単に統合**\n* 🌐 **MCP SDKとの完全な互換性**\n\n## 🔍 Claude アプリを使用した OpenAI 検索統合デモ！🚀\n\n\n\nOpenAI は、強力な LLM に最適化されたツールを自社のエージェントプラットフォーム内に閉じ込めようとしましたが、MCP の止められないオープンソースの動きを止めることはできませんでした。\n\n## 開発者のジレンマ\n\nAI 開発者は現在、2 つのエコシステムの間で難しい選択を迫られています。\n\n```mermaid\ngraph TD\n subgraph \"Developer's Dilemma\"\n style Developer fill:#ff9e64,stroke:#fff,stroke-width:2px\n Developer((Developer))\n end\n\n subgraph \"OpenAI's Ecosystem\"\n style OpenAITools fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Tracing fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Evaluation fill:#bb9af7,stroke:#fff,stroke-width:2px\n style VendorLock fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n OpenAITools[\"Built-in Tools
(Web Search, Code Interpreter)\"]\n Tracing[\"Advanced Tracing
(Visual Debugging)\"]\n Evaluation[\"Evaluation Dashboards
(Performance Metrics)\"]\n VendorLock[\"Vendor Lock-in
⚠️ Closed Source ⚠️\"]\n\n OpenAITools --> Tracing\n Tracing --> Evaluation\n OpenAITools -.-> VendorLock\n Tracing -.-> VendorLock\n Evaluation -.-> VendorLock\n end\n\n subgraph \"MCP Ecosystem\"\n style MCPStandard fill:#7dcfff,stroke:#fff,stroke-width:2px\n style MCPTools fill:#7dcfff,stroke:#fff,stroke-width:2px\n style OpenStandard fill:#9ece6a,stroke:#fff,stroke-width:2px\n style LimitedTools fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n MCPStandard[\"Model Context Protocol
(Open Standard)\"]\n MCPTools[\"MCP-compatible Tools\"]\n OpenStandard[\"Open Ecosystem
✅ Interoperability ✅\"]\n LimitedTools[\"Limited Tool Quality
⚠️ Less Mature (e.g., web search, computer use) ⚠️\"]\n\n MCPStandard --> MCPTools\n MCPStandard --> OpenStandard\n MCPTools -.-> LimitedTools\n end\n\n Developer -->|\"Wants powerful tools
& visualizations\"| OpenAITools\n Developer -->|\"Wants open standards
& interoperability\"| MCPStandard\n\n classDef highlight fill:#ff9e64,stroke:#fff,stroke-width:4px;\n class Developer highlight\n```\n\n**openai-tool2mcp は、** OpenAI の成熟した高品質のツールをオープン MCP エコシステム内で使用できるようにすることで、このギャップを埋めます。\n\n## 🌟 特徴\n\n* **簡単なセットアップ**:いくつかの簡単なコマンドで起動して実行できます\n* **OpenAIツールをMCPサーバーとして**:強力なOpenAI組み込みツールをMCP準拠サーバーとしてラップする\n* **シームレスな統合**: Claude App やその他の MCP 対応クライアントと連携\n* **MCP SDK互換**:公式MCP Python SDKを使用\n* **ツールサポート**:\n * 🔍 ウェブ検索\n * 💻 コードインタープリター\n * 🌐 ウェブブラウザ\n * 📁 ファイル管理\n* **オープンソース**：MITライセンス、ハッキング可能、拡張可能\n\n## 🚀 インストール\n\n```bash\n# Install from PyPI\npip install openai-tool2mcp\n\n# Or install the latest development version\npip install git+https://github.com/alohays/openai-tool2mcp.git\n\n# Recommended: Install uv for better MCP compatibility\npip install uv\n```\n\n### 前提条件\n\n* Python 3.10以上\n* アシスタント API にアクセスできる OpenAI API キー\n* (推奨) MCP 互換性のための uv パッケージマネージャー\n\n## 🛠️ クイックスタート\n\n1. **OpenAI API キーを設定します**:\n\n```bash\nexport OPENAI_API_KEY=\"your-api-key-here\"\n```\n\n2. **OpenAI ツールを使用して MCP サーバーを起動します**。\n\n```bash\n# Recommended: Use uv for MCP compatibility (recommended by MCP documentation)\nuv run openai_tool2mcp/server_entry.py --transport stdio\n\n# Or use the traditional method with the CLI\nopenai-tool2mcp start --transport stdio\n```\n\n3. **Claude for Desktop での使用**:\n\nclaude\\_desktop\\_config.json を編集して、Claude for Desktop がサーバーを使用するように設定します。\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/openai-tool2mcp\",\n \"run\",\n \"openai_tool2mcp/server_entry.py\"\n ]\n }\n }\n}\n```\n\n設定ファイルは次の場所にあります:\n\n* MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n* Windows: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 💻 使用例\n\n### 基本的なサーバー構成\n\n```python\n# server_script.py\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Configure with OpenAI web search\nconfig = ServerConfig(\n openai_api_key=\"your-api-key\",\n tools=[OpenAIBuiltInTools.WEB_SEARCH.value]\n)\n\n# Create and start server with STDIO transport (for MCP compatibility)\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nMCP の推奨に従って`uv`で実行します。\n\n```bash\nuv run server_script.py\n```\n\n### Claude デスクトップの MCP 互換構成\n\nスタンドアロンスクリプトを作成します。\n\n```python\n# openai_tools_server.py\nimport os\nfrom dotenv import load_dotenv\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Load environment variables\nload_dotenv()\n\n# Create a server with multiple tools\nconfig = ServerConfig(\n openai_api_key=os.environ.get(\"OPENAI_API_KEY\"),\n tools=[\n OpenAIBuiltInTools.WEB_SEARCH.value,\n OpenAIBuiltInTools.CODE_INTERPRETER.value\n ]\n)\n\n# Create and start the server with stdio transport for MCP compatibility\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nこのスクリプトを`uv`で使用するように Claude Desktop を設定します。\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/project/folder\",\n \"run\",\n \"openai_tools_server.py\"\n ]\n }\n }\n}\n```\n\n## 📊 仕組み\n\nこのライブラリは、OpenAI Assistant API と MCP プロトコル間のブリッジとして機能します。\n\n```mermaid\nsequenceDiagram\n participant Claude as \"Claude App\"\n participant MCP as \"MCP Client\"\n participant Server as \"openai-tool2mcp Server\"\n participant OpenAI as \"OpenAI API\"\n\n Claude->>MCP: User query requiring tools\n MCP->>Server: MCP request\n Server->>OpenAI: Convert to OpenAI format\n OpenAI->>Server: Tool response\n Server->>MCP: Convert to MCP format\n MCP->>Claude: Display result\n```\n\n## 🔄 MCP SDK 統合\n\n`openai-tool2mcp`は MCP SDK と完全に互換性を持つようになりました。Claude for Desktop アプリで以下の手順で使用できます。\n\n1. `pip install openai-tool2mcp`でパッケージをインストールする\n2. `claude_desktop_config.json`に以下を含めるように設定します。\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"openai-tool2mcp\",\n \"args\": [\n \"start\",\n \"--transport\",\n \"stdio\",\n \"--tools\",\n \"retrieval\",\n \"code_interpreter\"\n ]\n }\n }\n}\n```\n\n設定ファイルは次の場所にあります:\n\n* MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n* Windows: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 🤝 貢献する\n\nコミュニティからの貢献を歓迎します！ご協力いただける方法は以下の通りです。\n\n1. リポジトリ**をフォークする**\n2. フォークをローカルマシンに**クローンする**\n3. 機能やバグ修正用の**ブランチを作成する**\n4. **変更を加え**てコミットする\n5. フォークに**プッシュし**て**プルリクエスト**を送信します\n\n必ず弊社のコーディング標準に従い、新しい機能に対してテストを追加してください。\n\n### 開発セットアップ\n\n```bash\n# Clone the repository\ngit clone https://github.com/alohays/openai-tool2mcp.git\ncd openai-tool2mcp\n\n# Install in development mode\nmake install\n\n# Run tests\nmake test\n\n# Run linting\nmake lint\n```\n\n## 📄 ライセンス\n\nこのプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については[LICENSE](LICENSE)ファイルを参照してください。\n\n## 🙏 謝辞\n\n* 優れたツールとAPIを提供してくれたOpenAIチーム\n* ツールの使用に関するオープンスタンダードを開発するMCPコミュニティ\n* このプロジェクトの改善にご協力いただいたすべての貢献者\n\n***\n\n## ⚠️プロジェクトのステータス\n\nこのプロジェクトは現在開発中です。コア機能は動作しますが、頻繁なアップデートと改善が予定されています。問題が発生した場合は、[問題追跡システム](https://github.com/alohays/openai-tool2mcp/issues)からご報告ください。\n\n***\n\n*openai-tool2mcp は、OpenAI のツールとオープンソースの MCP エコシステムを結び付ける、より広範な[MCPortal](https://github.com/alohays/mcportal)イニシアチブの一部です。*","Japanese","ja-JP",{"_29":54,"_33":57,"_38":58},{"_31":55,"_33":34,"_35":56},"OpenAI의 내장 도구(웹 검색 및 코드 인터프리터 등)를 Model Context Protocol 서버로 래핑하여 Claude 및 기타 MCP 호환 모델과 함께 사용할 수 있는 가벼운 브리지입니다.","# openai-tool2mcp\n\n[![풀어 주다](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)[![빌드 상태](https://img.shields.io/github/actions/workflow/status/alohays/openai-tool2mcp/main.yml?branch=main)](https://github.com/alohays/openai-tool2mcp/actions/workflows/main.yml?query=branch%3Amain) [![코드코브](https://codecov.io/gh/alohays/openai-tool2mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/alohays/openai-tool2mcp) [![활동 커밋](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp)](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp) [![특허](https://img.shields.io/github/license/alohays/openai-tool2mcp)](https://img.shields.io/github/license/alohays/openai-tool2mcp)\n\n**openai-tool2mcp는** OpenAI의 강력한 내장 도구를 모델 컨텍스트 프로토콜(MCP) 서버로 래핑하는 가벼운 오픈소스 브릿지입니다. 이를 통해 Claude 및 기타 MCP 호환 모델과 함께 웹 검색 및 코드 인터프리터와 같은 고품질 OpenAI 도구를 사용할 수 있습니다.\n\n* 🔍 **Claude 앱에서 OpenAI의 강력한 웹 검색을 사용하세요**\n* 💻 **MCP 호환 LLM에서 액세스 코드 인터프리터 기능**\n* 🔄 **OpenAI와 MCP 간의 원활한 프로토콜 변환**\n* 🛠️ **간편한 통합을 위한 간단한 API**\n* 🌐 **MCP SDK와 완벽한 호환성**\n\n## 🔍 Claude 앱과 OpenAI 검색 통합 데모! 🚀\n\n\n\nOpenAI는 강력하고 LLM에 최적화된 도구를 자체 에이전트 플랫폼 내에 묶어두려고 했지만, 멈출 수 없는 MCP의 오픈 소스 운동을 막을 수는 없었습니다!\n\n## 개발자의 딜레마\n\nAI 개발자들은 현재 두 가지 생태계 중에서 어려운 선택을 해야 합니다.\n\n지엑스피1\n\n**openai-tool2mcp는** 개방형 MCP 생태계 내에서 OpenAI의 성숙하고 고품질의 도구를 사용할 수 있도록 하여 이러한 격차를 해소합니다.\n\n## 🌟 특징\n\n* **간편한 설정** : 몇 가지 간단한 명령으로 시작 및 실행\n* **MCP 서버로서의 OpenAI 도구** : 강력한 OpenAI 내장 도구를 MCP 호환 서버로 래핑\n* **원활한 통합** : Claude 앱 및 기타 MCP 호환 클라이언트와 함께 작동합니다.\n* **MCP SDK 호환** : 공식 MCP Python SDK 사용\n* **도구 지원** :\n * 🔍 웹 검색\n * 💻 코드 인터프리터\n * 🌐 웹 브라우저\n * 📁 파일 관리\n* **오픈 소스** : MIT 라이선스, 해킹 및 확장 가능\n\n## 🚀 설치\n\n```bash\n# Install from PyPI\npip install openai-tool2mcp\n\n# Or install the latest development version\npip install git+https://github.com/alohays/openai-tool2mcp.git\n\n# Recommended: Install uv for better MCP compatibility\npip install uv\n```\n\n### 필수 조건\n\n* 파이썬 3.10+\n* Assistant API에 액세스할 수 있는 OpenAI API 키\n* (추천) MCP 호환성을 위한 uv 패키지 관리자\n\n## 🛠️ 빠른 시작\n\n1. **OpenAI API 키를 설정하세요** :\n\n```bash\nexport OPENAI_API_KEY=\"your-api-key-here\"\n```\n\n2. **OpenAI 도구로 MCP 서버를 시작합니다** .\n\n```bash\n# Recommended: Use uv for MCP compatibility (recommended by MCP documentation)\nuv run openai_tool2mcp/server_entry.py --transport stdio\n\n# Or use the traditional method with the CLI\nopenai-tool2mcp start --transport stdio\n```\n\n3. **Claude for Desktop과 함께 사용** :\n\nclaude\\_desktop\\_config.json을 편집하여 Claude for Desktop이 서버를 사용하도록 구성하세요.\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/openai-tool2mcp\",\n \"run\",\n \"openai_tool2mcp/server_entry.py\"\n ]\n }\n }\n}\n```\n\n구성 파일은 다음 위치에 있습니다.\n\n* MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n* 윈도우: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 💻 사용 예시\n\n### 기본 서버 구성\n\n```python\n# server_script.py\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Configure with OpenAI web search\nconfig = ServerConfig(\n openai_api_key=\"your-api-key\",\n tools=[OpenAIBuiltInTools.WEB_SEARCH.value]\n)\n\n# Create and start server with STDIO transport (for MCP compatibility)\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\nMCP에서 권장하는 대로 `uv` 로 실행하세요.\n\n```bash\nuv run server_script.py\n```\n\n### Claude Desktop용 MCP 호환 구성\n\n독립 실행형 스크립트를 만듭니다.\n\n```python\n# openai_tools_server.py\nimport os\nfrom dotenv import load_dotenv\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Load environment variables\nload_dotenv()\n\n# Create a server with multiple tools\nconfig = ServerConfig(\n openai_api_key=os.environ.get(\"OPENAI_API_KEY\"),\n tools=[\n OpenAIBuiltInTools.WEB_SEARCH.value,\n OpenAIBuiltInTools.CODE_INTERPRETER.value\n ]\n)\n\n# Create and start the server with stdio transport for MCP compatibility\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\n`uv` 와 함께 이 스크립트를 사용하도록 Claude Desktop을 구성합니다.\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/project/folder\",\n \"run\",\n \"openai_tools_server.py\"\n ]\n }\n }\n}\n```\n\n## 📊 작동 원리\n\n이 라이브러리는 OpenAI Assistant API와 MCP 프로토콜 간의 브리지 역할을 합니다.\n\n```mermaid\nsequenceDiagram\n participant Claude as \"Claude App\"\n participant MCP as \"MCP Client\"\n participant Server as \"openai-tool2mcp Server\"\n participant OpenAI as \"OpenAI API\"\n\n Claude->>MCP: User query requiring tools\n MCP->>Server: MCP request\n Server->>OpenAI: Convert to OpenAI format\n OpenAI->>Server: Tool response\n Server->>MCP: Convert to MCP format\n MCP->>Claude: Display result\n```\n\n## 🔄 MCP SDK 통합\n\n`openai-tool2mcp` 는 이제 MCP SDK와 완벽하게 호환됩니다. Claude for Desktop 앱과 함께 사용하는 방법은 다음과 같습니다.\n\n1. `pip install openai-tool2mcp` 로 패키지 설치\n2. `claude_desktop_config.json` 구성하여 다음을 포함합니다.\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"openai-tool2mcp\",\n \"args\": [\n \"start\",\n \"--transport\",\n \"stdio\",\n \"--tools\",\n \"retrieval\",\n \"code_interpreter\"\n ]\n }\n }\n}\n```\n\n구성 파일은 다음 위치에 있습니다.\n\n* MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n* 윈도우: `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 🤝 기여하기\n\n커뮤니티 여러분의 참여를 환영합니다! 참여 방법은 다음과 같습니다.\n\n1. 저장소를 **포크하세요**\n2. 로컬 머신에 포크를 **복제하세요**\n3. 기능이나 버그 수정을 위한 **브랜치를 만드세요**\n4. **변경 사항을 만들고** 커밋하세요\n5. 포크에 **푸시** 하고 **풀 리퀘스트를** 제출하세요\n\n당사의 코딩 표준을 준수하고 새로운 기능에 대한 테스트를 추가해 주시기 바랍니다.\n\n### 개발 설정\n\n```bash\n# Clone the repository\ngit clone https://github.com/alohays/openai-tool2mcp.git\ncd openai-tool2mcp\n\n# Install in development mode\nmake install\n\n# Run tests\nmake test\n\n# Run linting\nmake lint\n```\n\n## 📄 라이센스\n\n이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 [라이선스](LICENSE) 파일을 참조하세요.\n\n## 🙏 감사의 말\n\n* 뛰어난 도구와 API를 제공하는 OpenAI 팀\n* 도구 사용을 위한 개방형 표준을 개발하는 MCP 커뮤니티\n* 이 프로젝트 개선에 도움을 준 모든 기여자\n\n***\n\n## ⚠️ 프로젝트 상태\n\n이 프로젝트는 현재 개발 중입니다. 핵심 기능은 정상적으로 작동하며, 정기적인 업데이트와 개선이 있을 예정입니다. 문제가 발생하면 [이슈 트래커](https://github.com/alohays/openai-tool2mcp/issues) 에 제출해 주세요.\n\n***\n\n*openai-tool2mcp는 OpenAI 도구와 오픈 소스 MCP 생태계를 연결하는 광범위한 [MCPortal](https://github.com/alohays/mcportal) 이니셔티브의 일부입니다.*","Korean","ko-KR",{"_29":60,"_33":63,"_38":64},{"_31":61,"_33":34,"_35":62},"一种轻量级桥梁，将 OpenAI 的内置工具（如网络搜索和代码解释器）包装为模型上下文协议服务器，使其能够与 Claude 和其他 MCP 兼容模型一起使用。","# openai-tool2mcp\n\n[![发布](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)](https://img.shields.io/github/v/release/alohays/openai-tool2mcp)[![构建状态](https://img.shields.io/github/actions/workflow/status/alohays/openai-tool2mcp/main.yml?branch=main)](https://github.com/alohays/openai-tool2mcp/actions/workflows/main.yml?query=branch%3Amain) [![代码验证](https://codecov.io/gh/alohays/openai-tool2mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/alohays/openai-tool2mcp) [![提交活动](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp)](https://img.shields.io/github/commit-activity/m/alohays/openai-tool2mcp) [![执照](https://img.shields.io/github/license/alohays/openai-tool2mcp)](https://img.shields.io/github/license/alohays/openai-tool2mcp)\n\n**openai-tool2mcp**是一个轻量级的开源桥接器，它将 OpenAI 强大的内置工具包装为模型上下文协议 (MCP) 服务器。它使您能够将高质量的 OpenAI 工具（例如网页搜索和代码解释器）与 Claude 和其他兼容 MCP 的模型一起使用。\n\n* 🔍**在 Claude App 中使用 OpenAI 强大的网络搜索**\n* 💻**在任何与 MCP 兼容的 LLM 中访问代码解释器功能**\n* 🔄 **OpenAI 和 MCP 之间的无缝协议转换**\n* 🛠️**简单的 API，易于集成**\n* 🌐**与 MCP SDK 完全兼容**\n\n## 🔍 OpenAI 搜索与 Claude App 集成演示！🚀\n\n\n\nOpenAI 试图将其强大的、针对 LLM 优化的工具锁定在自己的代理平台内，但他们无法阻止 MCP 不可阻挡的开源运动！\n\n## 开发者的困境\n\n人工智能开发人员目前面临着两个生态系统之间的艰难选择：\n\n```mermaid\ngraph TD\n subgraph \"Developer's Dilemma\"\n style Developer fill:#ff9e64,stroke:#fff,stroke-width:2px\n Developer((Developer))\n end\n\n subgraph \"OpenAI's Ecosystem\"\n style OpenAITools fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Tracing fill:#bb9af7,stroke:#fff,stroke-width:2px\n style Evaluation fill:#bb9af7,stroke:#fff,stroke-width:2px\n style VendorLock fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n OpenAITools[\"Built-in Tools
(Web Search, Code Interpreter)\"]\n Tracing[\"Advanced Tracing
(Visual Debugging)\"]\n Evaluation[\"Evaluation Dashboards
(Performance Metrics)\"]\n VendorLock[\"Vendor Lock-in
⚠️ Closed Source ⚠️\"]\n\n OpenAITools --> Tracing\n Tracing --> Evaluation\n OpenAITools -.-> VendorLock\n Tracing -.-> VendorLock\n Evaluation -.-> VendorLock\n end\n\n subgraph \"MCP Ecosystem\"\n style MCPStandard fill:#7dcfff,stroke:#fff,stroke-width:2px\n style MCPTools fill:#7dcfff,stroke:#fff,stroke-width:2px\n style OpenStandard fill:#9ece6a,stroke:#fff,stroke-width:2px\n style LimitedTools fill:#f7768e,stroke:#fff,stroke-width:2px,stroke-dasharray: 5 5\n\n MCPStandard[\"Model Context Protocol
(Open Standard)\"]\n MCPTools[\"MCP-compatible Tools\"]\n OpenStandard[\"Open Ecosystem
✅ Interoperability ✅\"]\n LimitedTools[\"Limited Tool Quality
⚠️ Less Mature (e.g., web search, computer use) ⚠️\"]\n\n MCPStandard --> MCPTools\n MCPStandard --> OpenStandard\n MCPTools -.-> LimitedTools\n end\n\n Developer -->|\"Wants powerful tools
& visualizations\"| OpenAITools\n Developer -->|\"Wants open standards
& interoperability\"| MCPStandard\n\n classDef highlight fill:#ff9e64,stroke:#fff,stroke-width:4px;\n class Developer highlight\n```\n\n**openai-tool2mcp**通过让您在开放的 MCP 生态系统中使用 OpenAI 成熟、高质量的工具来弥补这一差距。\n\n## 🌟 功能\n\n* **轻松设置**：使用几个简单的命令即可启动并运行\n* **OpenAI 工具作为 MCP 服务器**：将强大的 OpenAI 内置工具包装为符合 MCP 标准的服务器\n* **无缝集成**：与 Claude App 和其他 MCP 兼容客户端兼容\n* **MCP SDK 兼容**：使用官方 MCP Python SDK\n* **工具支持**：\n * 🔍 网页搜索\n * 💻 代码解释器\n * 🌐 网络浏览器\n * 📁 文件管理\n* **开源**：MIT 许可，可破解且可扩展\n\n## 🚀 安装\n\n```bash\n# Install from PyPI\npip install openai-tool2mcp\n\n# Or install the latest development version\npip install git+https://github.com/alohays/openai-tool2mcp.git\n\n# Recommended: Install uv for better MCP compatibility\npip install uv\n```\n\n### 先决条件\n\n* Python 3.10+\n* 可访问 Assistant API 的 OpenAI API 密钥\n* （推荐）uv 包管理器，兼容 MCP\n\n## 🛠️ 快速入门\n\n1. **设置您的 OpenAI API 密钥**：\n\n```bash\nexport OPENAI_API_KEY=\"your-api-key-here\"\n```\n\n2. **使用 OpenAI 工具启动 MCP 服务器**：\n\n```bash\n# Recommended: Use uv for MCP compatibility (recommended by MCP documentation)\nuv run openai_tool2mcp/server_entry.py --transport stdio\n\n# Or use the traditional method with the CLI\nopenai-tool2mcp start --transport stdio\n```\n\n3. **与 Claude 桌面版一起使用**：\n\n通过编辑 claude\\_desktop\\_config.json 配置 Claude for Desktop 以使用服务器：\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/openai-tool2mcp\",\n \"run\",\n \"openai_tool2mcp/server_entry.py\"\n ]\n }\n }\n}\n```\n\n配置文件位于：\n\n* MacOS： `~/Library/Application Support/Claude/claude_desktop_config.json`\n* Windows： `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 💻 使用示例\n\n### 基本服务器配置\n\n```python\n# server_script.py\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Configure with OpenAI web search\nconfig = ServerConfig(\n openai_api_key=\"your-api-key\",\n tools=[OpenAIBuiltInTools.WEB_SEARCH.value]\n)\n\n# Create and start server with STDIO transport (for MCP compatibility)\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\n按照 MCP 的建议使用`uv`运行它：\n\n```bash\nuv run server_script.py\n```\n\n### Claude Desktop 的 MCP 兼容配置\n\n创建独立脚本：\n\n```python\n# openai_tools_server.py\nimport os\nfrom dotenv import load_dotenv\nfrom openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools\n\n# Load environment variables\nload_dotenv()\n\n# Create a server with multiple tools\nconfig = ServerConfig(\n openai_api_key=os.environ.get(\"OPENAI_API_KEY\"),\n tools=[\n OpenAIBuiltInTools.WEB_SEARCH.value,\n OpenAIBuiltInTools.CODE_INTERPRETER.value\n ]\n)\n\n# Create and start the server with stdio transport for MCP compatibility\nserver = MCPServer(config)\nserver.start(transport=\"stdio\")\n```\n\n配置 Claude Desktop 将此脚本与`uv`一起使用：\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/absolute/path/to/your/project/folder\",\n \"run\",\n \"openai_tools_server.py\"\n ]\n }\n }\n}\n```\n\n## 📊 工作原理\n\n该库充当 OpenAI Assistant API 和 MCP 协议之间的桥梁：\n\n```mermaid\nsequenceDiagram\n participant Claude as \"Claude App\"\n participant MCP as \"MCP Client\"\n participant Server as \"openai-tool2mcp Server\"\n participant OpenAI as \"OpenAI API\"\n\n Claude->>MCP: User query requiring tools\n MCP->>Server: MCP request\n Server->>OpenAI: Convert to OpenAI format\n OpenAI->>Server: Tool response\n Server->>MCP: Convert to MCP format\n MCP->>Claude: Display result\n```\n\n## 🔄 MCP SDK 集成\n\n`openai-tool2mcp`现已完全兼容 MCP SDK。您可以通过以下方式将其与 Claude 桌面应用配合使用：\n\n1. 使用`pip install openai-tool2mcp`安装软件包\n2. 配置您的`claude_desktop_config.json`以包含：\n\n```json\n{\n \"mcpServers\": {\n \"openai-tools\": {\n \"command\": \"openai-tool2mcp\",\n \"args\": [\n \"start\",\n \"--transport\",\n \"stdio\",\n \"--tools\",\n \"retrieval\",\n \"code_interpreter\"\n ]\n }\n }\n}\n```\n\n配置文件位于：\n\n* MacOS： `~/Library/Application Support/Claude/claude_desktop_config.json`\n* Windows： `%AppData%\\Claude\\claude_desktop_config.json`\n\n## 🤝 贡献\n\n欢迎社区贡献力量！您可以通过以下方式提供帮助：\n\n1. **分叉**存储库\n2. 将您的 fork**克隆**到本地机器\n3. 为您的功能或错误修复**创建一个分支**\n4. **进行更改**并提交\n5. **推**送到你的 fork 并提交**拉取请求**\n\n请确保遵循我们的编码标准并为任何新功能添加测试。\n\n### 开发设置\n\n```bash\n# Clone the repository\ngit clone https://github.com/alohays/openai-tool2mcp.git\ncd openai-tool2mcp\n\n# Install in development mode\nmake install\n\n# Run tests\nmake test\n\n# Run linting\nmake lint\n```\n\n## 📄 许可证\n\n该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅[LICENSE](LICENSE)文件。\n\n## 🙏 致谢\n\n* OpenAI 团队提供的出色工具和 API\n* MCP 社区致力于开发工具使用的开放标准\n* 所有帮助改进此项目的贡献者\n\n***\n\n## ⚠️ 项目状态\n\n该项目正在积极开发中。在核心功能正常运行的同时，预计会频繁更新和改进。如果您遇到任何问题，请在我们的[问题跟踪器](https://github.com/alohays/openai-tool2mcp/issues)上提交。\n\n***\n\n*openai-tool2mcp 是更广泛的[MCPortal](https://github.com/alohays/mcportal)计划的一部分，旨在将 OpenAI 的工具与开源 MCP 生态系统连接起来。*","Chinese","zh-CN","githubUser","locale",{"_68":69,"_70":71,"_13":82,"_90":32,"_91":32,"_92":93,"_96":97,"_118":-5,"_16":119,"_120":121,"_122":123,"_33":34,"_155":109,"_156":-5,"_157":-5,"_158":159,"_160":-5,"_161":162,"_167":-5,"_130":34,"_168":169,"_172":-5,"_110":173,"_174":175},"addedAt","2025-03-14T03:01:27.204204157Z","argumentsJsonSchema",{"_72":73,"_79":80,"_77":81},"properties",{"_74":75},"OPENAI_API_KEY",{"_31":76,"_77":78},"Your OpenAI API key with access to the Assistant API","type","string","required",[74],"object",[83,84,85,86,87,88,89],"category:rag-systems","category:search","category:code-execution","environment:network","hosting:hybrid","language:python","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_94":95},"url","https://github.com/alohays/openai-tool2mcp","githubRepository",{"_98":99,"_100":101,"_102":103,"_104":105,"_33":34,"_106":107,"_112":113,"_114":115,"_117":113},"defaultBranch","main","fullName","alohays/openai-tool2mcp","githubTreeId",85822,"language","Python","owner",{"_108":109,"_110":111},"login","alohays","uid","MSoOGfcatk","recentStargazers",8,"spdxLicense",{"_33":116},"MIT License","stargazers","glamaJson",1834,"inspectable",false,"integrations",[124,134,141,148],{"_125":126,"_31":132,"_110":133},"brand",{"_127":128,"_33":129,"_130":131},"logoSvgPath","M12.006.481C5.391.486.005 5.831 0 12.399v.03l2.042 1.19.028-.018a5.82 5.82 0 013.308-1.02c.37 0 .733.034 1.085.1l-.036-.006a5.69 5.69 0 012.874 1.43l-.004-.002.35.326.198-.434c.192-.42.414-.814.66-1.173.1-.144.208-.29.332-.446l.205-.257-.252-.211a8.33 8.33 0 00-3.836-1.807l-.052-.008a8.565 8.565 0 00-4.08.251l.06-.016c.972-4.256 4.714-7.223 9.133-7.226a9.31 9.31 0 016.6 2.713 9.196 9.196 0 012.508 4.498 8.385 8.385 0 00-2.498-.379h-.154c-.356.006-.7.033-1.036.078l.045-.005-.042.006a8.103 8.103 0 00-.39.06c-.057.01-.114.022-.17.033a8.102 8.102 0 00-.392.09l-.138.034a9.21 9.21 0 00-.483.144l-.03.01c-.354.12-.708.268-1.05.44l-.027.013c-.152.076-.305.16-.47.256l-.035.022a8.216 8.216 0 00-2.108 1.8l-.011.014-.075.092a8.345 8.345 0 00-.378.503c-.088.13-.177.269-.288.452l-.06.104a8.985 8.985 0 00-.234.432l-.016.029c-.17.34-.317.698-.44 1.063l-.017.053a8.052 8.052 0 00-.41 2.716v-.007.112a12 12 0 00.023.431l-.002-.037a11.676 11.676 0 00.042.412l.005.042.013.103c.018.127.038.252.062.378.241 1.266.845 2.532 1.745 3.66l.041.051.042-.05c.359-.424 1.249-1.77 1.325-2.577v-.015l-.006-.013a5.56 5.56 0 01-.64-2.595c0-3.016 2.37-5.521 5.396-5.702l.2-.007a5.93 5.93 0 013.47 1.025l.027.019L24 12.416v-.03a11.77 11.77 0 00-3.51-8.423A11.962 11.962 0 0012.007.48z","Codecov","slug","codecov","Provides code coverage reporting and tracking for the project.","awcc133f94",{"_125":135,"_31":139,"_110":140},{"_127":136,"_33":137,"_130":138},"M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12","GitHub","github","Integrates with GitHub for project management, allowing access to repositories and supporting workflows through GitHub Actions.","l6noijm3vq",{"_125":142,"_31":146,"_110":147},{"_127":143,"_33":144,"_130":145},"M23.99 2.115A12.223 12.223 0 0 0 12 10.149 12.223 12.223 0 0 0 .01 2.115a12.23 12.23 0 0 0 5.32 10.604 6.562 6.562 0 0 1 2.845 5.423v3.754h7.65v-3.754a6.561 6.561 0 0 1 2.844-5.423 12.223 12.223 0 0 0 5.32-10.604Z","Mermaid","mermaid","Utilizes Mermaid for creating diagrams to visualize workflow processes and architecture.","qbmxrd41sr",{"_125":149,"_31":153,"_110":154},{"_127":150,"_33":151,"_130":152},"M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z","OpenAI","openai","Wraps OpenAI's built-in tools (web search, code interpreter, web browser, file management) as MCP servers, making them available to other MCP-compatible models.","tvf480s6oc","namespace","npmPackage","prompts","redditPostForeignId","1jbvq18","resources","scores",{"_163":164,"_165":-5,"_166":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[170,171],"MACOS","WINDOWS","tools","g37l0aejsr","updatedAt","2025-03-20T17:54:51.093093921Z","meta",[178,181,183,190,193,195,198,201,204,207,210,212,215,218,220,222,224,226,228],{"_179":180},"title","openai-tool2mcp | Glama",{"_182":32,"_33":31},"content",{"_184":185,"_186":187,"_188":189},"href","https://glama.ai/mcp/servers/@alohays/openai-tool2mcp","rel","canonical","tagName","link",{"_182":34,"_191":192},"property","og:title",{"_182":32,"_191":194},"og:description",{"_182":196,"_191":197},"https://glama.ai/logo.png","og:logo",{"_182":199,"_191":200},"https://glama.ai/mcp/servers/@alohays/openai-tool2mcp/og-image","og:image",{"_182":202,"_191":203},"630","og:image:height",{"_182":205,"_191":206},"1200","og:image:width",{"_182":208,"_191":209},"website","og:type",{"_182":185,"_191":211},"og:url",{"_182":213,"_191":214},"Glama – MCP Hosting Platform","og:site_name",{"_182":216,"_33":217},"summary_large_image","twitter:card",{"_182":213,"_33":219},"twitter:title",{"_182":32,"_33":221},"twitter:description",{"_182":199,"_33":223},"twitter:image",{"_182":202,"_33":225},"twitter:image:height",{"_182":205,"_33":227},"twitter:image:width",{"_229":230},"script:ld+json",{"_231":232,"_233":234},"@context","http://schema.org","@graph",[235],{"_231":236,"_237":238,"_239":240},"https://schema.org","@type","BreadcrumbList","itemListElement",[241,248,252,256],{"_237":242,"_243":244,"_33":245,"_246":247},"ListItem","item","https://glama.ai/","Glama","position",1,{"_237":242,"_243":249,"_33":250,"_246":251},"https://glama.ai/mcp","MCP",2,{"_237":242,"_243":253,"_33":254,"_246":255},"https://glama.ai/mcp/servers","Servers",3,{"_237":242,"_243":185,"_33":34,"_246":257},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_65":-5,"_29":261,"_176":282,"_317":-5},{"_68":69,"_70":262,"_13":266,"_90":32,"_91":32,"_92":267,"_96":268,"_118":-5,"_16":119,"_120":121,"_122":271,"_33":34,"_155":109,"_156":-5,"_157":-5,"_158":159,"_160":-5,"_161":280,"_167":-5,"_130":34,"_168":281,"_172":-5,"_110":173,"_174":175},{"_72":263,"_79":265,"_77":81},{"_74":264},{"_31":76,"_77":78},[74],[83,84,85,86,87,88,89],{"_35":36,"_94":95},{"_98":99,"_100":101,"_102":103,"_104":105,"_33":34,"_106":269,"_112":113,"_114":270,"_117":113},{"_108":109,"_110":111},{"_33":116},[272,274,276,278],{"_125":273,"_31":132,"_110":133},{"_127":128,"_33":129,"_130":131},{"_125":275,"_31":139,"_110":140},{"_127":136,"_33":137,"_130":138},{"_125":277,"_31":146,"_110":147},{"_127":143,"_33":144,"_130":145},{"_125":279,"_31":153,"_110":154},{"_127":150,"_33":151,"_130":152},{"_163":164,"_165":-5,"_166":-5},[170,171],[283,285,287,289,291,292,293,294,295,296,297,298,299,300,301,302,303,304,305],{"_179":284},"Reviews | openai-tool2mcp | Glama",{"_182":286,"_33":31},"Read community reviews and feedback for openai-tool2mcp. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_184":288,"_186":187,"_188":189},"https://glama.ai/mcp/servers/@alohays/openai-tool2mcp/reviews",{"_182":290,"_191":192},"Reviews | openai-tool2mcp",{"_182":286,"_191":194},{"_182":196,"_191":197},{"_182":199,"_191":200},{"_182":202,"_191":203},{"_182":205,"_191":206},{"_182":208,"_191":209},{"_182":288,"_191":211},{"_182":213,"_191":214},{"_182":216,"_33":217},{"_182":213,"_33":219},{"_182":286,"_33":221},{"_182":199,"_33":223},{"_182":202,"_33":225},{"_182":205,"_33":227},{"_229":306},{"_231":232,"_233":307},[308],{"_231":236,"_237":238,"_239":309},[310,311,312,313,314],{"_237":242,"_243":244,"_33":245,"_246":247},{"_237":242,"_243":249,"_33":250,"_246":251},{"_237":242,"_243":253,"_33":254,"_246":255},{"_237":242,"_243":185,"_33":34,"_246":257},{"_237":242,"_243":288,"_33":315,"_246":316},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API