OpenAI扩展模型服务

提供GPT-5系列和Codex模型的扩展支持,适用于代码审查、设计评审和一般推理任务。

  • by kent013
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 kent013/mcp-openai-extended

使用说明

MCP OpenAI扩展

用于OpenAI的扩展模型上下文协议(MCP)服务器,支持GPT-5系列,包括专门的Codex模型。

特性

  • ✅ GPT-5家族支持(GPT-5、GPT-5.1、GPT-5.2,聊天最新/专业/迷你/纳米/codex变体)
  • ✅ GPT-4o和o1系列支持
  • ✅ 响应API支持 用于Codex模型(*codex*)
  • ✅ 自动选择API端点(针对codex的响应API,针对其他人的聊天完成)
  • ✅ 适用于Claude Desktop、Claude Code和任何兼容MCP的客户端

支持的型号

GPT-5系列

  • gpt-5-codex - 专门用于代码和设计审查 (默认情况下,使用Responses API)
  • gpt-5.3-codex
  • gpt-5.3-codex-spark
  • gpt-5.2-chat-latest
  • gpt-5.2-pro
  • gpt-5.2
  • gpt-5.2-codex
  • gpt-5.1-chat-latest
  • gpt-5.1-codex
  • gpt-5.1-codex-mini
  • gpt-5.1-codex-max
  • gpt-5.1
  • gpt-5-chat-latest
  • codex-mini-latest
  • gpt-5-pro
  • gpt-5
  • gpt-5-mini
  • gpt-5-nano

注:较新的Codex模型ID在API请求中工作之前可能需要帐户级访问权限。

GPT-4系列

  • gpt-4o -GPT-4 Omni
  • gpt-4o-mini -较小的GPT-4o

o1系列

  • o1 -推理模型
  • o1-preview -推理模型预览
  • o1-mini -较小的推理模型

安装

NPM(推荐)

npm install -g @kent013/mcp-openai-extended

通过npx(GitHub)

npx github:kent013/mcp-openai-extended

本地开发

git clone https://github.com/kent013/mcp-openai-extended.git
cd mcp-openai-extended
npm install
npm run build

配置

⚠️ 安全警告

切勿将您的API密钥提交给版本控制!

  • 保持你的 OPENAI_API_KEY 在环境变量或安全配置文件中
  • 将包含API密钥的配置文件添加到 .gitignore
  • 如果您意外提交了API密钥, 立即撤销 在https://platform.openai.com/api-keys
  • 定期旋转API键

克劳德桌面/克劳德代码

添加到您的 .mcp.json 或 claude_desktop_config.json:

{
  "mcpServers": {
    "openai": {
      "command": "npx",
      "args": ["-y", "@kent013/mcp-openai-extended"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

本地开发

{
  "mcpServers": {
    "openai": {
      "command": "node",
      "args": ["/path/to/mcp-openai-extended/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

用法

服务器提供了一个工具: openai_chat

默认型号为 gpt-5-codex (自动使用响应API)。

示例:使用GPT-5.2 Codex进行设计审查(默认)

{
  "name": "openai_chat",
  "arguments": {
    "messages": [
      {
        "role": "system",
        "content": "You are an experienced system architect."
      },
      {
        "role": "user",
        "content": "Review this code:\n\n```php\n$user = User::find($id);\nMail::to($user->email)->send(new TestMail());\n```"
      }
    ]
    // model defaults to "gpt-5-codex"
  }
}

示例:GPT-5聊天最新的一般推理

{
  "name": "openai_chat",
  "arguments": {
    "messages": [
      {
        "role": "user",
        "content": "Explain quantum computing in simple terms"
      }
    ],
    "model": "gpt-5-chat-latest"
  }
}

API终点

此服务器自动选择适当的OpenAI API终结点:

  • 响应API (/v1/responses):适用于Codex型号(*codex*)
  • 聊天完成API (/v1/chat/completions):适用于所有其他型号(gpt-4o、gpt-5-chat-latest等)

环境变量

  • OPENAI_API_KEY (必需):您的OpenAI API密钥

获取API密钥

  1. 访问https://platform.openai.com/api-keys
  2. 创建新的API密钥
  3. 安全存放- 永远不要将其共享或提交给版本控制
  4. 设置适当的使用限制,以防止意外收费

最佳实践

  • 使用特定于环境的API密钥(开发、阶段、生产)
  • 在您的OpenAI帐户中启用使用警报
  • 定期审查API的使用情况和旋转键
  • 使用OpenAI的API密钥限制功能来限制密钥权限

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/index.js

贡献

欢迎投稿!请随时提交拉取请求。

许可证

麻省理工学院

学分

基于 mcp openai 通过mzxrai。

扩展以支持GPT-5系列和专用型号。