Openai Tool2mcp

🚀 開源項目：openai-tool2mcp 中文文檔

openai-tool2mcp 是一款開源工具，它能讓 OpenAI 的原生工具（像網絡搜索、代碼解釋器等）與 MCP 協議兼容。藉助該工具，用戶可在 MCP 生態系統中運用 OpenAI 提供的強大功能。

🚀 快速開始

本工具可讓你在 MCP 生態系統中使用 OpenAI 的強大功能。以下是快速上手的步驟：

示例 1：基本使用

# 基本腳本示例
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

config = ServerConfig(
    openai_api_key="你的API密鑰",
    tools=[OpenAIBuiltInTools.WEB_SEARCH.value]
)

server = MCPServer(config)
server.start(transport="stdio")

示例 2：配置為 MCP 兼容服務器

# 配置 MCP 兼容腳本示例
import os
from dotenv import load_dotenv
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

load_dotenv()

config = ServerConfig(
    openai_api_key=os.environ.get("OPENAI_API_KEY"),
    tools=[
        OpenAIBuiltInTools.WEB_SEARCH.value,
        OpenAIBuiltInTools.CODE_INTERPRETER.value
    ]
)

server = MCPServer(config)
server.start(transport="stdio")

✨ 主要特性

• 將 OpenAI 的原生工具（如網絡搜索、代碼解釋器）與 MCP 協議兼容。
• 允許用戶在 MCP 生態系統中使用 OpenAI 提供的強大功能。

📦 安裝指南

使用 pip 安裝

pip install openai-tool2mcp

克隆倉庫（用於開發）

git clone https://github.com/alohays/openai-tool2mcp.git
cd openai-tool2mcp

💻 使用示例

基礎用法

# 基本腳本示例
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

config = ServerConfig(
    openai_api_key="你的API密鑰",
    tools=[OpenAIBuiltInTools.WEB_SEARCH.value]
)

server = MCPServer(config)
server.start(transport="stdio")

高級用法

# 配置 MCP 兼容腳本示例
import os
from dotenv import load_dotenv
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

load_dotenv()

config = ServerConfig(
    openai_api_key=os.environ.get("OPENAI_API_KEY"),
    tools=[
        OpenAIBuiltInTools.WEB_SEARCH.value,
        OpenAIBuiltInTools.CODE_INTERPRETER.value
    ]
)

server = MCPServer(config)
server.start(transport="stdio")

📚 詳細文檔

項目架構

序列圖說明

sequenceDiagram
    participant Claude as "Claude App"
    participant MCP as "MCP 客戶端"
    participant Server as "openai-tool2mcp 服務器"
    participant OpenAI as "OpenAI API"

    Claude->>MCP: 用戶查詢需要工具支持
    MCP->>Server: MCP 請求
    Server->>OpenAI: 轉換為 OpenAI 格式請求
    OpenAI->>Server: 工具響應
    Server->>MCP: 轉換為 MCP 格式響應
    MCP->>Claude: 顯示結果

與 MCP SDK 集成

安裝步驟

pip install openai-tool2mcp

配置文件示例（適用於 Claude for Desktop）

{
  "mcpServers": {
    "openai-tools": {
      "command": "openai-tool2mcp",
      "args": [
        "start",
        "--transport",
        "stdio",
        "--tools",
        "retrieval",
        "code_interpreter"
      ]
    }
  }
}

🔧 技術細節

該項目旨在將 OpenAI 的原生工具與 MCP 協議兼容，允許用戶在 MCP 生態系統中使用 OpenAI 提供的強大功能。通過序列圖可以清晰地看到，當用戶通過 Claude App 查詢需要工具支持時，MCP 客戶端會向 openai-tool2mcp 服務器發送請求，服務器將請求轉換為 OpenAI 格式併發送給 OpenAI API，獲取工具響應後再將其轉換為 MCP 格式返回給 MCP 客戶端，最終顯示給用戶。

🤝 貢獻指南

參與方式

1. Fork 該項目倉庫
2. Clone 到本地機器
3. 創建功能或修復分支
4. 提交更改並創建 Pull Request

開發設置

# 克隆倉庫
git clone https://github.com/alohays/openai-tool2mcp.git
cd openai-tool2mcp

# 以開發模式安裝
make install

# 運行測試
make test

# 執行代碼檢查
make lint

📄 許可證

本項目採用 MIT 許可證，具體細節請參閱 LICENSE 文件。

🙏 致謝

• OpenAI 團隊，感謝他們提供的優秀工具和 API
• MCP 社區，感謝開發開放標準協議
• 所有為改進該項目做出貢獻的社區成員

📈 項目狀態

該項目處於積極開發階段。核心功能正常運行，但可能會有頻繁更新和改進。如遇問題，請在我們的 問題跟蹤器 提交。

openai-tool2mcp 是更廣泛 MCPortal 計劃的一部分，旨在將 OpenAI 的工具與開源 MCP 生態系統連接起來。