openai-tool2mcp
2025.03.14
9
Python协议转换工具集成开发效率
openai-tool2mcp 是一个轻量级的开源桥接工具，它将 OpenAI 强大的内置工具封装为 Model Context Protocol (MCP) 服务器。通过该工具，用户可以在 Claude 和其他兼容 MCP 的模型中使用 OpenAI 的高质量工具，如网页搜索和代码解释器。
View on GitHub
Overview
基本能力
产品定位
openai-tool2mcp 旨在解决开发者在使用 OpenAI 工具和 MCP 生态系统之间的选择难题，通过将 OpenAI 的成熟工具引入开放的 MCP 生态系统，实现两者的无缝集成。
核心功能
- OpenAI 工具封装：将 OpenAI 的内置工具（如网页搜索、代码解释器、网页浏览器和文件管理）封装为 MCP 兼容的服务器。
- 协议转换：在 OpenAI 和 MCP 协议之间进行无缝转换。
- 简单 API：提供易于集成的 API。
- MCP SDK 兼容：完全兼容 MCP Python SDK。
适用场景
- 在 Claude 应用中使用 OpenAI 的网页搜索功能。
- 在任何兼容 MCP 的 LLM 中访问代码解释器功能。
- 开发者需要在 OpenAI 和 MCP 生态系统之间进行工具集成的场景。
工具列表
- 网页搜索（WEB_SEARCH）：提供强大的网页搜索能力。
- 代码解释器（CODE_INTERPRETER）：支持代码执行和解释。
- 网页浏览器（WEB_BROWSER）：模拟浏览器行为。
- 文件管理（FILE_MANAGEMENT）：支持文件的上传、下载和管理。
常见问题解答
- 如何配置 Claude 桌面应用使用该工具？
编辑
claude_desktop_config.json文件，配置mcpServers部分以指向该工具的启动脚本。 - 是否需要 OpenAI API 密钥？ 是的，需要有效的 OpenAI API 密钥，并且需要访问 Assistant API。
使用教程
使用依赖
- Python 3.10+
- OpenAI API 密钥
- （推荐）uv 包管理器
安装教程
# 从 PyPI 安装
pip install openai-tool2mcp
# 或安装最新开发版本
pip install git+https://github.com/alohays/openai-tool2mcp.git
# 推荐安装 uv 以增强 MCP 兼容性
pip install uv
调试方式
- 设置 OpenAI API 密钥：
export OPENAI_API_KEY="your-api-key-here"
- 启动 MCP 服务器：
uv run openai_tool2mcp/server_entry.py --transport stdio
- 配置 Claude 桌面应用以使用该服务器，编辑
claude_desktop_config.json文件。