使用说明

项目简介

本项目 'mcp-openai' 是一个 Model Context Protocol (MCP) 服务器,旨在弥合 Claude 桌面应用和 OpenAI 模型之间的鸿沟。它允许用户在 Claude 中直接调用 OpenAI 的强大语言模型,例如 gpt-4o 和 gpt-4o-mini,从而扩展 Claude 的能力,使用户可以在 Claude 的界面内体验到不同模型的优势。

主要功能点

  • 集成 OpenAI 模型: 允许 Claude 用户直接使用 OpenAI 提供的先进模型,包括 gpt-4o, gpt-4o-mini, o1-preview, o1-mini。
  • 工具化调用: 通过 'openai_chat' 工具,用户可以明确指示 Claude 使用 OpenAI 模型进行对话和内容生成。
  • 简单的消息传递接口: 采用 MCP 协议,与 Claude 客户端通过标准化的 JSON-RPC 协议通信,易于理解和集成。
  • 基础错误处理: 提供基础的错误处理机制,帮助用户识别和解决使用过程中可能出现的问题。

安装步骤

  1. 安装 Claude 桌面应用: 确保已安装 Claude Desktop app 并且可以正常使用。

  2. 获取 OpenAI API Key: 访问 OpenAI API keys 页面,注册或登录 OpenAI 账号并创建一个新的 API Key。请妥善保管你的 API Key,避免泄露。

  3. 配置 'claude_desktop_config.json':

    • 找到 Claude 桌面应用的配置文件 'claude_desktop_config.json'。在 macOS 系统中,该文件通常位于 '~/Library/Application\ Support/Claude/' 目录下。
    • 使用文本编辑器打开 'claude_desktop_config.json' 文件。
    • 在 'mcpServers' 字段下添加 'mcp-openai' 服务器的配置信息,如果 'mcpServers' 字段不存在,请手动创建。
    • 将以下 JSON 代码片段复制粘贴到 'mcpServers' 字段中,并将 'your-api-key-here' 替换为你刚刚获取的 OpenAI API Key
    {
      "mcpServers": {
        "mcp-openai": {
          "command": "npx",  // 启动服务器的命令,这里使用 npx 执行 npm 包
          "args": ["-y", "@mzxrai/mcp-openai@latest"], // 命令参数,-y 表示自动确认安装,@mzxrai/mcp-openai@latest 指定要执行的 npm 包及其版本
          "env": {
            "OPENAI_API_KEY": "your-api-key-here (get one from https://platform.openai.com/api-keys)" // 环境变量,用于传递 OpenAI API Key 给服务器
          }
        }
      }
    }
    • 保存 'claude_desktop_config.json' 文件。

服务器配置

上述安装步骤中的 'claude_desktop_config.json' 配置已经包含了服务器的必要配置信息。Claude 桌面应用会根据这些配置启动 'mcp-openai' 服务器。

关键配置项说明:

  • 'server name': 'mcp-openai' - 服务器的名称,用于在 Claude 客户端中标识和引用。
  • 'command': 'npx' - 执行命令,这里使用 'npx' 来运行 npm 包。
  • 'args': '["-y", "@mzxrai/mcp-openai@latest"]' - 传递给 'npx' 的参数,指定要运行的 npm 包为 '@mzxrai/mcp-openai' 的最新版本。 '-y' 参数表示自动确认安装 npm 包。
  • 'env': '{"OPENAI_API_KEY": "your-api-key-here"}' - 环境变量配置,将 OpenAI API Key ('OPENAI_API_KEY') 设置为你的 API Key。 请务必替换 'your-api-key-here' 为你自己的 API Key。

基本使用方法

配置完成后,启动或重启 Claude 桌面应用。你可以通过自然语言指示 Claude 使用 OpenAI 模型。

例如,你可以这样说:

  • "Can you ask o1 what it thinks about this problem?" (你能问问 o1 模型对这个问题怎么看吗?)
  • "What does gpt-4o think about this?" (gpt-4o 模型对此有何看法?)

支持的模型包括:

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

当 Claude 识别到你希望使用 OpenAI 模型时,它会调用 'mcp-openai' 服务器,并使用 'openai_chat' 工具与 OpenAI API 进行交互,然后将结果返回给你。

查看 MCP 服务器日志:

如果在使用过程中遇到问题,可以查看 Claude 桌面应用的 MCP 日志,日志文件通常位于 '~/Library/Logs/Claude/' 目录下,文件名以 'mcp' 开头。通过查看日志可以帮助你诊断问题。

信息

分类

AI与计算