Claude Code Openai MCP

OpenAI MCP服务器

MCP服务器，将OpenAI引入Claude Code——文本生成、头脑风暴、代码审查、解释、网络搜索、推理、代码执行、URL获取、图像生成/编辑/分析、文本到语音和转录。支持GPT-5.2、GPT-5.2-Codex、o4-mini、GPT-image 1.5和Whisper型号。

快速开始

步骤1：获取API密钥

1. 首选 OpenAI平台
2. 创建帐户或登录
3. 生成API密钥
4. 复制密钥（您将在步骤3中需要它）

步骤2：安装先决条件

• Node.js 18+ - 点击此处下载
• 克劳德代码CLI - 安装指南

步骤3：安装MCP服务器

3.1克隆存储库

git clone https://github.com/wynandw87/claude-code-openai-mcp.git
cd claude-code-openai-mcp

3.2安装依赖项

macOS/Linux/Windows：

npm install

注： 安装依赖项后，服务器将在一个步骤中自动构建。

3.3使用克劳德代码注册

选择您的安装范围：

替换 YOUR_API_KEY 使用实际的OpenAI API密钥，并使用 dist/index.js.

提示： 要获取完整路径，请从克隆的目录运行以下命令： - macOS/Linux： echo "$(pwd)/dist/index.js" - 窗户： echo %cd%\dist\index.js

macOS/Linux：

claude mcp add -s user OpenAI -e OPENAI_API_KEY=YOUR_API_KEY -- node /full/path/to/dist/index.js

Windows（CMD）：

claude mcp add -s user OpenAI -e "OPENAI_API_KEY=YOUR_API_KEY" -- node "C:\full\path\to\dist\index.js"

Windows（PowerShell）：

claude mcp add -s user OpenAI -e "OPENAI_API_KEY=YOUR_API_KEY" '--' node "C:\full\path\to\dist\index.js"

替代方案：使用安装脚本

安装脚本自动处理依赖关系的安装、构建和注册。

macOS/Linux：

chmod +x setup.sh
./setup.sh YOUR_API_KEY

Windows（PowerShell）：

.\setup.ps1 -ApiKey YOUR_API_KEY

或者使用npm助手（如果在环境中设置了API密钥）：

export OPENAI_API_KEY=YOUR_API_KEY
npm run install:claude

步骤4：重新启动Claude代码

关闭并重新打开Claude Code以使更改生效。

步骤5：验证安装

claude mcp list

你应该看看 OpenAI 以“已连接”状态列出。

______________________________________________________________________

特性

文本与推理

• 通用查询 (ask)-灵活的界面，可查询任何支持的OpenAI模型
• 头脑风暴 (brainstorm)-创造性思维
• 代码审查 (code_review)-彻底的代码分析
• 解释 (explain)-使用GPT-5-mini进行清晰的概念解释
• 推理 (search_with_reasoning)-扩展了o4-mini/o3模型的推理

搜索和网络

• 网页搜索 (search_web)-引用的实时网络搜索
• URL获取 (fetch_url)-获取和分析网页

代码和文件

• 代码执行 (run_code)-使用NumPy、Pandas、Matplotlib、SciPy在服务器端执行Python
• 文件上传 (upload_file)-上传文件进行分析（任何基于文本的文件；PDF、CSV、代码等）

图像

• 图像生成 (generate_image)-使用gpt-image 1.5将文本转换为图像
• 图像编辑 (edit_image)-使用自然语言和可选掩码编辑现有图像
• 图像分析 (analyze_image)-用于描述和分析图像的视觉模型

音频

• 文本转语音 (text_to_speech)-使用10个语音选项将文本转换为语音
• 转录 (transcribe)-使用Whisper进行语音转文本

______________________________________________________________________

用法

安装后，使用触发器短语调用OpenAI：

或者自然地问：

• *“询问OpenAI对这种方法的看法”*
• *“让OpenAI审查此代码是否存在安全问题”*
• *“与OpenAI就扩展策略进行头脑风暴”*
• *“OpenAI在网上搜索有关AI的最新消息”*
• *“OpenAI运行代码计算10年内的复利”*
• *“将此CSV上传到OpenAI，并要求它汇总数据”*
• *“OpenAI生成一个未来城市的图像”*
• *“OpenAI描述了此屏幕截图中的内容”*
• *“OpenAI使用nova语音将此文本转换为语音”*
• *“OpenAI转录此录音”*

______________________________________________________________________

工具参考

问

使用自定义提示查询任何OpenAI模型。

参数：

• prompt （string，必填）-问题或指令
• model （字符串，可选）-模型标识符（默认为 gpt-5.2)
• file_ids （string\[\]，可选）-将以前上传的文件ID作为上下文包含在内

代码查看

进行彻底的代码分析。

参数：

• code （string，必填）-要查看的代码
• focus （字符串，可选）-特定关注领域（例如，“安全”、“性能”）

头脑风暴

获得创意和头脑风暴的帮助。

参数：

• topic （string，必填）-头脑风暴的主题
• context （字符串，可选）-其他上下文

解释

使用GPT-5-mini获得清晰的解释。

参数：

• concept （string，必填）-解释什么

搜索web

用实时结果和引文搜索网络。

参数：

• query （字符串，必填）-搜索查询或问题
• model （字符串，可选）-模型标识符（默认为 gpt-5.2)

搜索_无理由

用扩展推理进行查询。展示模型的思维过程。

参数：

• prompt （string，必填）-问题或难题
• model （字符串，可选）-模型标识符（默认为 o4-mini)
• effort （字符串，可选）- "low", "medium", "high" （默认值： "high")

run_code

在OpenAI的沙盒环境中执行Python代码。

参数：

• prompt （字符串，必填）-描述要计算或分析的内容
• model （字符串，可选）-模型标识符（默认为 gpt-5.2)

环境： Python，预装NumPy、Pandas、Matplotlib、SciPy。

fetch_url

获取并分析网页内容。

参数：

• prompt （字符串，必填）-关于URL内容的问题或说明
• urls （string\[\]，必填）-要获取和分析的URL（最多20个）
• model （字符串，可选）-模型标识符（默认为 gpt-5.2)

上传文件

上传文档以供分析。支持大多数基于文本的文件格式。

具有本机支持的扩展名的文件(.c, .css, .csv, .html, .java, .js, .json, .md, .pdf, .py, .sh, .txt, .xml, .yaml等等）通过OpenAI文件API上传。其他基于文本的文件(.ts, .tsx, .go, .rs, .swift, .kt, .sql, .toml等等）被读取并作为文本内联传递——对代码文件没有格式限制。

参数：

• file_path （string，必填）-要上传的文件的绝对路径
• query （string，可选）-上传后立即询问文件的问题
• model （字符串，可选）-模型标识符（默认为 gpt-5.2)

generate_image

使用gpt-image 1.5生成图像。内联返回图像并保存到磁盘。

参数：

• prompt （字符串，必填）-图像生成提示
• size （字符串，可选）- "auto", "1024x1024", "1536x1024", "1024x1536"
• quality （字符串，可选）- "auto", "low", "medium", "high"
• n （整数，可选）-图像数量（1-10，默认值：1）
• save_path （字符串，可选）-保存图像的文件路径

edit_image

使用自然语言指令编辑现有图像。

参数：

• prompt （字符串，必填）-编辑说明
• image_path （string，必填）-源图像的绝对路径
• mask_path （字符串，可选）-遮罩图像的路径（透明区域=编辑区）
• size （字符串，可选）- "auto", "1024x1024", "1536x1024", "1024x1536"
• quality （字符串，可选）- "auto", "low", "medium", "high"
• save_path （字符串，可选）-保存编辑图像的文件路径

分析图像

使用OpenAI的视觉功能分析图像。

参数：

• image_path （string，必填）-图像文件的绝对路径
• prompt （字符串，可选）-关于图像的问题（默认：“详细描述此图像”）
• model （字符串，可选）-模型标识符（默认为 gpt-5.2)

文本到语音

将文本转换为语音音频。

参数：

• text （string，必填）-要转换的文本
• voice （字符串，可选）- "alloy", "ash", "ballad", "coral", "echo", "fable", "onyx", "nova", "sage", "shimmer"
• model （字符串，可选）- "gpt-4o-mini-tts" （默认）， "tts-1", "tts-1-hd"
• speed （数字，可选）-0.25到4.0（默认值：1.0）
• format （字符串，可选）- "mp3" （默认）， "opus", "aac", "flac", "wav", "pcm"
• save_path （字符串，可选）-保存音频的文件路径

转录

将音频转录为文本。

参数：

• audio_path （字符串，必填）-音频文件的路径（mp3、mp4、mpeg、mpga、m4a、wav、webm）
• model （字符串，可选）- "whisper-1" （默认）， "gpt-4o-transcribe", "gpt-4o-mini-transcribe"
• language （字符串，可选）-ISO-639-1语言代码（例如，“en”、“es”、“fr”）
• prompt （字符串，可选）-指导转录风格的上下文

______________________________________________________________________

支持的型号

文本模型

编码模型

推理模型

图像模型

音频模型

______________________________________________________________________

配置

环境变量

______________________________________________________________________

运作原理

此MCP服务器使用官方 openai npm包用于与OpenAI模型通信。它通过stdio传输连接到Claude Code。

提供的工具：

______________________________________________________________________

故障排除

修复API密钥

如果您输入了错误的API密钥，请删除并重新安装：

claude mcp remove OpenAI

然后使用上述步骤3.3中的命令重新安装（使用与最初安装时相同的作用域）。

MCP服务器未显示

检查服务器是否已安装：

claude mcp list

如果未列出，请按照步骤3进行安装。

服务器无法启动

1. 验证您的API密钥 有效期为 OpenAI平台

1. 检查Node.js版本 （需要18+）：

   node --version

1. 确保服务器已构建 --如果 dist/index.js 不见了，快跑 npm install 再次

连接错误

1. 检查一下 dist/index.js 存在 --如果没有，运行 npm install
2. 验证路径是否为绝对路径 在你的 claude mcp add 命令
3. 重新启动Claude代码 在任何配置更改后

超时错误

• 推理和搜索工具使用延长超时（3-5x基数）
• 增加 OPENAI_TIMEOUT 慢速连接的环境变量

查看当前配置

claude mcp list

______________________________________________________________________

贡献

欢迎拉取请求！请保持简单，对初学者友好。

许可证

麻省理工学院

______________________________________________________________________

专为Claude Code社区打造