openai-tool2mcp

openai-tool2mcp는 OpenAI의 강력한 내장 도구를 모델 컨텍스트 프로토콜(MCP) 서버로 래핑하는 가벼운 오픈소스 브릿지입니다. 이를 통해 Claude 및 기타 MCP 호환 모델과 함께 웹 검색 및 코드 인터프리터와 같은 고품질 OpenAI 도구를 사용할 수 있습니다.

🔍 Claude 앱에서 OpenAI의 강력한 웹 검색을 사용하세요
💻 MCP 호환 LLM에서 액세스 코드 인터프리터 기능
🔄 OpenAI와 MCP 간의 원활한 프로토콜 변환
🛠️ 간편한 통합을 위한 간단한 API
🌐 MCP SDK와 완벽한 호환성

🔍 Claude 앱과 OpenAI 검색 통합 데모! 🚀

https://github.com/user-attachments/assets/f1f10e2c-b995-4e03-8b28-61eeb2b2bfe9

OpenAI는 강력하고 LLM에 최적화된 도구를 자체 에이전트 플랫폼 내에 묶어두려고 했지만, 멈출 수 없는 MCP의 오픈 소스 운동을 막을 수는 없었습니다!

개발자의 딜레마

AI 개발자들은 현재 두 가지 생태계 중에서 어려운 선택을 해야 합니다.

지엑스피1

openai-tool2mcp는 개방형 MCP 생태계 내에서 OpenAI의 성숙하고 고품질의 도구를 사용할 수 있도록 하여 이러한 격차를 해소합니다.

🌟 특징

간편한 설정 : 몇 가지 간단한 명령으로 시작 및 실행
MCP 서버로서의 OpenAI 도구 : 강력한 OpenAI 내장 도구를 MCP 호환 서버로 래핑
원활한 통합 : Claude 앱 및 기타 MCP 호환 클라이언트와 함께 작동합니다.
MCP SDK 호환 : 공식 MCP Python SDK 사용
도구 지원 :
- 🔍 웹 검색
- 💻 코드 인터프리터
- 🌐 웹 브라우저
- 📁 파일 관리
오픈 소스 : MIT 라이선스, 해킹 및 확장 가능

🚀 설치

# Install from PyPI
pip install openai-tool2mcp

# Or install the latest development version
pip install git+https://github.com/alohays/openai-tool2mcp.git

# Recommended: Install uv for better MCP compatibility
pip install uv

필수 조건

파이썬 3.10+
Assistant API에 액세스할 수 있는 OpenAI API 키
(추천) MCP 호환성을 위한 uv 패키지 관리자

🛠️ 빠른 시작

OpenAI API 키를 설정하세요 :

export OPENAI_API_KEY="your-api-key-here"

OpenAI 도구로 MCP 서버를 시작합니다 .

# Recommended: Use uv for MCP compatibility (recommended by MCP documentation)
uv run openai_tool2mcp/server_entry.py --transport stdio

# Or use the traditional method with the CLI
openai-tool2mcp start --transport stdio

Claude for Desktop과 함께 사용 :

claude_desktop_config.json을 편집하여 Claude for Desktop이 서버를 사용하도록 구성하세요.

{
  "mcpServers": {
    "openai-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/openai-tool2mcp",
        "run",
        "openai_tool2mcp/server_entry.py"
      ]
    }
  }
}

구성 파일은 다음 위치에 있습니다.

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우: %AppData%\Claude\claude_desktop_config.json

💻 사용 예시

기본 서버 구성

# server_script.py
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

# Configure with OpenAI web search
config = ServerConfig(
    openai_api_key="your-api-key",
    tools=[OpenAIBuiltInTools.WEB_SEARCH.value]
)

# Create and start server with STDIO transport (for MCP compatibility)
server = MCPServer(config)
server.start(transport="stdio")

MCP에서 권장하는 대로 uv 로 실행하세요.

uv run server_script.py

Claude Desktop용 MCP 호환 구성

독립 실행형 스크립트를 만듭니다.

# openai_tools_server.py
import os
from dotenv import load_dotenv
from openai_tool2mcp import MCPServer, ServerConfig, OpenAIBuiltInTools

# Load environment variables
load_dotenv()

# Create a server with multiple tools
config = ServerConfig(
    openai_api_key=os.environ.get("OPENAI_API_KEY"),
    tools=[
        OpenAIBuiltInTools.WEB_SEARCH.value,
        OpenAIBuiltInTools.CODE_INTERPRETER.value
    ]
)

# Create and start the server with stdio transport for MCP compatibility
server = MCPServer(config)
server.start(transport="stdio")

uv 와 함께 이 스크립트를 사용하도록 Claude Desktop을 구성합니다.

{
  "mcpServers": {
    "openai-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/project/folder",
        "run",
        "openai_tools_server.py"
      ]
    }
  }
}

📊 작동 원리

이 라이브러리는 OpenAI Assistant API와 MCP 프로토콜 간의 브리지 역할을 합니다.

🔄 MCP SDK 통합

openai-tool2mcp 는 이제 MCP SDK와 완벽하게 호환됩니다. Claude for Desktop 앱과 함께 사용하는 방법은 다음과 같습니다.

pip install openai-tool2mcp 로 패키지 설치
claude_desktop_config.json 구성하여 다음을 포함합니다.

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

구성 파일은 다음 위치에 있습니다.

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우: %AppData%\Claude\claude_desktop_config.json

🤝 기여하기

커뮤니티 여러분의 참여를 환영합니다! 참여 방법은 다음과 같습니다.

저장소를 포크하세요
로컬 머신에 포크를 복제하세요
기능이나 버그 수정을 위한 브랜치를 만드세요
변경 사항을 만들고 커밋하세요
포크에 푸시 하고 풀 리퀘스트를 제출하세요

당사의 코딩 표준을 준수하고 새로운 기능에 대한 테스트를 추가해 주시기 바랍니다.

개발 설정

# 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

# Run linting
make lint

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

뛰어난 도구와 API를 제공하는 OpenAI 팀
도구 사용을 위한 개방형 표준을 개발하는 MCP 커뮤니티
이 프로젝트 개선에 도움을 준 모든 기여자

⚠️ 프로젝트 상태

이 프로젝트는 현재 개발 중입니다. 핵심 기능은 정상적으로 작동하며, 정기적인 업데이트와 개선이 있을 예정입니다. 문제가 발생하면 이슈 트래커 에 제출해 주세요.

openai-tool2mcp는 OpenAI 도구와 오픈 소스 MCP 생태계를 연결하는 광범위한 MCPortal 이니셔티브의 일부입니다.

openai-tool2mcp

Integrations

openai-tool2mcp

🔍 Claude 앱과 OpenAI 검색 통합 데모! 🚀

개발자의 딜레마

🌟 특징

🚀 설치

필수 조건

🛠️ 빠른 시작

💻 사용 예시

기본 서버 구성

Claude Desktop용 MCP 호환 구성

📊 작동 원리

🔄 MCP SDK 통합

🤝 기여하기

개발 설정

📄 라이센스

🙏 감사의 말

⚠️ 프로젝트 상태

Related Resources

Appeared in Searches