返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端