Back to MCP directory
publicPublicdnsLocal runtime

mcp-openai

一个让Claude无缝使用OpenAI模型的MCP服务器

article

README

🚀 OpenAI MCP 服务器

OpenAI MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器,它能让你直接在 Claude 中使用 OpenAI 的模型,为用户提供了便捷的跨模型使用体验。

🚀 快速开始

只需确保你已经按照安装步骤配置好环境,然后开始与 Claude 进行对话。当你想使用 OpenAI 的模型时,告知 Claude 使用相应模型即可开启交互。

✨ 主要特性

  • 模型集成:直接集成 OpenAI 的对话模型,无缝对接。
  • 多模型支持:支持多种模型,包括 gpt-4ogpt-4o-minio1-previewo1-mini
  • 简洁接口:提供简单的消息传递接口,便于使用。
  • 错误处理:具备基本的错误处理机制,保障运行稳定。

📦 安装指南

先决条件

安装步骤

首先,确保你已经安装了 Claude 桌面应用 并且获取了一个 OpenAI API密钥

将以下内容添加到你的 claude_desktop_config.json 中(在 Mac 上,该文件位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-openai": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-openai@latest"],
      "env": {
        "OPENAI_API_KEY": "在此处填写你的 API 密钥(从 https://platform.openai.com/api-keys 获取)"
      }
    }
  }
}

这个配置能让 Claude 桌面应用在需要时启动 OpenAI MCP 服务器。

💻 使用示例

基础用法

只需开始与 Claude 进行对话,当你想使用 OpenAI 的模型时,告知 Claude 使用它们即可。例如:

你能问 o1 对这个问题有什么看法吗?

gpt-4o 是怎么看待这个的?

当前服务器支持以下模型:

  • gpt-4o(默认)
  • gpt-4o-mini
  • o1-preview
  • o1-mini

高级用法

openai_chat 工具

  • 功能:发送消息到 OpenAI 的对话完成 API。
  • 参数
    • messages:消息数组(必需)
    • model:使用的模型(可选,默认为 gpt-4o

🔧 技术细节

这是 alpha 版本的软件,可能存在一些问题。如果你遇到问题,请查看 Claude 桌面的 MCP 日志:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

🛠️ 开发指南

开发命令

# 安装依赖项
pnpm install

# 构建项目
pnpm build

# 监视更改
pnpm watch

# 开发模式下运行
pnpm dev

开发要求

  • Node.js >= 18
  • OpenAI API密钥

已验证平台

  • [x] macOS
  • [ ] Linux

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者

mzxrai

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client