使用说明
项目简介
本项目 '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 协议通信,易于理解和集成。
- 基础错误处理: 提供基础的错误处理机制,帮助用户识别和解决使用过程中可能出现的问题。
安装步骤
-
安装 Claude 桌面应用: 确保已安装 Claude Desktop app 并且可以正常使用。
-
获取 OpenAI API Key: 访问 OpenAI API keys 页面,注册或登录 OpenAI 账号并创建一个新的 API Key。请妥善保管你的 API Key,避免泄露。
-
配置 '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与计算