基本能力
产品定位
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 包管理器
安装教程
```bash
从 PyPI 安装
pip install openai-tool2mcp
或安装最新开发版本
pip install git+https://github.com/alohays/openai-tool2mcp.git
推荐安装 uv 以增强 MCP 兼容性
pip install uv
```
调试方式
- 设置 OpenAI API 密钥:
bash
export OPENAI_API_KEY="your-api-key-here" - 启动 MCP 服务器:
bash
uv run openai_tool2mcp/server_entry.py --transport stdio - 配置 Claude 桌面应用以使用该服务器,编辑
claude_desktop_config.json
文件。