Openai Tool2mcp

🚀 openai-tool2mcp

openai-tool2mcp is an open - source tool that enables compatibility between OpenAI's native tools (such as web search and code interpreter) and the MCP protocol. It allows users to leverage the powerful features provided by OpenAI within the MCP ecosystem.

🚀 Quick Start

Example 1: Basic Usage

# Basic script example
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

config = ServerConfig(
    openai_api_key="Your API Key",
    tools=[OpenAIBuiltInTools.WEB_SEARCH.value]
)

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

Example 2: Configure as an MCP - Compatible Server

# Example of configuring an MCP - compatible script
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")

✨ Features

openai-tool2mcp enables compatibility between OpenAI's native tools (such as web search and code interpreter) and the MCP protocol, allowing users to use OpenAI's powerful features in the MCP ecosystem.

📦 Installation

Install using pip

pip install openai-tool2mcp

Clone the repository (for development)

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

📚 Documentation

Project Architecture

Sequence Diagram

sequenceDiagram
    participant Claude as "Claude App"
    participant MCP as "MCP Client"
    participant Server as "openai-tool2mcp Server"
    participant OpenAI as "OpenAI API"

    Claude->>MCP: User query requires tool support
    MCP->>Server: MCP request
    Server->>OpenAI: Convert to OpenAI format request
    OpenAI->>Server: Tool response
    Server->>MCP: Convert to MCP format response
    MCP->>Claude: Display results

Integration with MCP SDK

Installation Steps

pip install openai-tool2mcp

Configuration File Example (for Claude for Desktop)

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

🔧 Technical Details

Contribution Guide

Participation Method

1. Fork the project repository.
2. Clone it to your local machine.
3. Create a feature or bug - fix branch.
4. Submit your changes and create a Pull Request.

Development Setup

# Clone the repository
git clone https://github.com/alohays/openai-tool2mcp.git
cd openai-tool2mcp

# Install in development mode
make install

# Run tests
make test

# Perform code checks
make lint

📄 License

This project is licensed under the MIT license. Please refer to the LICENSE file for specific details.

Acknowledgments

• The OpenAI team for providing excellent tools and APIs.
• The MCP community for developing an open - standard protocol.
• All community members who have contributed to improving this project.

Project Status

This project is in active development. The core functionality is operational, but there may be frequent updates and improvements. If you encounter any issues, please submit them to our issue tracker.

openai-tool2mcp is part of the broader MCPortal initiative, aiming to connect OpenAI's tools with the open - source MCP ecosystem.