mcp-openai 仓库详解

项目概述

功能特性

• OpenAI 模型的直接集成：用户可以直接从 Claude 应用中与 OpenAI 模型进行交互，无需中间网络请求。
• 支持多个模型：无论是强大的 gpt-4o，还是轻量化的 gpt-4o-mini 和 o1-mini，用户都有多种选择。
• 简便的信息传递接口：设计简单的消息传递机制，提高用户体验。
• 基础错误处理：即使是初期版本，也具备处理基础错误的能力，保障用户的使用体验。

先决条件

在使用该项目之前，请确保您的环境满足以下条件：

• 已在本地安装 Node.js 版本 18 或更高（包含npm和npx）。
• 已下载安装 Claude Desktop 应用。
• 已申请并获取 OpenAI API 密钥。

安装步骤

为了让您的 Claude Desktop 应用能够调用 OpenAI 的 MCP 服务器，请按照以下步骤进行配置：

1. 首先，确保您已经安装了 Claude Desktop 应用，并拥有 OpenAI 的 API 密钥。

2. 然后，打开（或创建）Claude 的配置文件 claude_desktop_config.json，在 macOS 系统中，该文件通常位于

   ~/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 Desktop 每次在需要时自动启动 OpenAI MCP 服务器。

使用方法

Can you ask o1 what it thinks about this problem?

What does gpt-4o think about this?

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

• 默认使用的 gpt-4o
• 轻量版本 gpt-4o-mini
• 预览版 o1-preview
• 轻量版 o1-mini

开发人员指南

对于开发者而言，该项目提供了一套简单易用的开发命令：

1. 安装依赖：使用 pnpm install 安装项目所需的所有依赖项。
2. 构建项目：通过运行 pnpm build 来构建整个项目。
3. 实时监控：使用 pnpm watch 命令在开发过程中实时监控和编译代码更改。
4. 开发模式运行：开发模式下，可以用 pnpm dev 命令进行调试和运行。

问题排除

本项目目前处于 alpha 版本，可能存在一些未解决的错误。如果您遇到问题，请检查 Claude Desktop 的 MCP 日志，使用以下命令查看最近日志：

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

应用场景与潜在价值

利用此项目，用户能够在本地桌面环境中充分发挥 OpenAI 模型的潜力。这在需要快速模型调用、解决复杂问题以及进行人机对话研究等场景中具有重要价值。

系统要求

• 必须拥有 Node.js 18 或以上的版本。
• 需要申请并设置 OpenAI API 密钥。

已验证的平台

• macOS
• 尚未验证的 Linux

许可证

本项目采用 MIT 许可证，更多详情请查阅相关许可证文件。

作者信息

通过仔细阅读以上文档，您应该能够顺利安装、配置、并使用 mcp-openai 项目。同时，对于开发者，也为您提供了基本的指南以便于进一步开发和贡献。