OpenAI模型集成服务

通过Antigravity环境中的模型上下文协议(MCP)集成和使用OpenAI模型的服务。

  • by maheshBawa
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 maheshBawa/Developer-guide-for-OpenAI-MCP-integration-

使用说明

开发者指南:在反重力中使用OpenAI模型

本指南解释了如何在反重力环境中通过模型上下文协议(MCP)集成和使用OpenAI模型。

1.了解MCP与基本模型

在开始之前,了解Antigravity如何处理模型非常重要:

  • 基础模型(“大脑”):这些是通过聊天界面中的模型选择器选择的主要模型(例如Gemini 3 Flash、Claude Sonnet)。它们充当代理的中央推理引擎。
  • MCP服务器(“插件”):MCP服务器使用工具扩展了基本模型。当你添加一个OpenAI MCP服务器时,你并没有添加一个新的可选“大脑”。相反,你让当前选择的基础模型能够按需调用OpenAI模型作为工具。

简言之: 基础模型决定 当 调用工具;MCP服务器定义 什么 工具可用。

2.获取您的OpenAI API密钥和信用

OpenAI API的使用与ChatGPT Plus是分开的。要通过MCP使用OpenAI模型,您必须启用API计费。

  1. 启用API帐单首选 账单仪表板.添加付款方式并设置一个小限额(例如5美元)。
  2. 创建API密钥首选 API密钥 并创建新的密钥。立即复制。

3.设置系统环境变量(稳健方法)

对于Windows用户来说,由于传播问题或路径处理,依赖系统环境变量有时会失败。最稳健的方法(也是为此环境配置的方法)是使用本地[.env](file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env)文件和自定义运行器脚本。

3.1创建[.env](file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env)文件

  1. 导航到您的Antigravity配置文件夹(通常 C:\Users\<YourUser>\.gemini\antigravity).
  2. 创建一个名为[.env]的文件(file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env).
  3. 将密钥添加到文件中:
    AI_CHAT_KEY="sk-proj-xxxxxxxxxxxxxxxxxxxxxxxx"
    
    (您也可以使用 OPENAI_API_KEY)
  4. 关键的:确保文件已保存 UTF-8编码(如果使用PowerShell/记事本,请注意不要另存为UTF-16/UCS-2,否则将无法读取密钥)。

3.2创建Runner脚本

为确保正确加载环境变量并可靠执行Windows命令,请使用包装器脚本。

  1. 创建一个名为[mcp.dotenv_wrunner.mjs]的文件(file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/mcp_dotenv_runner.mjs)与[.env]位于同一文件夹中(file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env)文件。
  2. 粘贴以下代码:
import { spawn } from "node:child_process";
import path from "node:path";
import process from "node:process";
import fs from "node:fs";
import { fileURLToPath } from "node:url";

function loadDotEnv(envPath) {
  if (!fs.existsSync(envPath)) return;

  const raw = fs.readFileSync(envPath, "utf8");
  for (const line of raw.split(/\r?\n/)) {
    const trimmed = line.trim();
    if (!trimmed || trimmed.startsWith("#")) continue;

    const idx = trimmed.indexOf("=");
    if (idx === -1) continue;
    
    const key = trimmed.slice(0, idx).trim();
    let val = trimmed.slice(idx + 1).trim();

    // strip surrounding quotes if present
    if (
      (val.startsWith('"') && val.endsWith('"')) ||
      (val.startsWith("'") && val.endsWith("'"))
    ) {
      val = val.slice(1, -1);
    }

    // Force override from file (solves stale env var issues)
    process.env[key] = val;
  }
}

// Load .env from same directory as this script
const envPath = path.join(path.dirname(fileURLToPath(import.meta.url)), ".env");
loadDotEnv(envPath);

// Ensure AI_CHAT_KEY is set
process.env.AI_CHAT_KEY =
  process.env.AI_CHAT_KEY || process.env.OPENAI_API_KEY || "";

const args = process.argv.slice(2);

// Windows: use npx.cmd with shell: true
const child = spawn("npx.cmd", args, {
  env: process.env,
  stdio: "inherit",
  shell: true, // Required for Windows .cmd execution
});

child.on("exit", (code) => process.exit(code ?? 1));

4.配置MCP服务器

现在配置Antigravity以使用此运行器脚本。

  1. 打开 管理MCP服务器 在《反重力》中。
  2. 点击 查看原始配置 (文件图标)。
  3. 添加或更新 mcpServers 对象如下。 替换 <YourUser> 使用您的实际Windows用户名。
{
  "mcpServers": {
    "openai-gpt-4-1": {
      "command": "node",
      "args": [
        "C:\\Users\\<YourUser>\\.gemini\\antigravity\\mcp_dotenv_runner.mjs",
        "-y",
        "@pyroprompts/any-chat-completions-mcp"
      ],
      "env": {
        "AI_CHAT_NAME": "OpenAI-GPT-4-1",
        "AI_CHAT_MODEL": "gpt-4.1",
        "AI_CHAT_BASE_URL": "https://api.openai.com/v1"
      }
    },
    "openai-gpt-4o-mini": {
      "command": "node",
      "args": [
        "C:\\Users\\<YourUser>\\.gemini\\antigravity\\mcp_dotenv_runner.mjs",
        "-y",
        "@pyroprompts/any-chat-completions-mcp"
      ],
      "env": {
        "AI_CHAT_NAME": "OpenAI-GPT-4o-mini",
        "AI_CHAT_MODEL": "gpt-4o-mini",
        "AI_CHAT_BASE_URL": "https://api.openai.com/v1"
      }
    },
    "openai-gpt-5-2": {
      "command": "node",
      "args": [
        "C:\\Users\\<YourUser>\\.gemini\\antigravity\\mcp_dotenv_runner.mjs",
        "-y",
        "@pyroprompts/any-chat-completions-mcp"
      ],
      "env": {
        "AI_CHAT_NAME": "OpenAI-GPT-5-2",
        "AI_CHAT_MODEL": "gpt-5.2",
        "AI_CHAT_BASE_URL": "https://api.openai.com/v1"
      }
    }
  }
}

5.型号可用性说明

  • GPT-4.1/GPT-4o-mini:广泛可用。
  • GPT-5.2:需要特定的访问权限和计费的OpenAI组织。如果5.2访问受到限制,请使用GPT-4o-mini进行一般测试。

6.如何使用和验证

  1. 重新筛选:更新配置后,单击MCP服务器列表中的“刷新”。
  2. 验证:如果工具出现在服务器名称下,则连接良好。
  3. 聊天:“使用GPT-5-2查看此代码。”

7.故障排除

  • 错误: spawn EINVAL:
    • 原因:Windows上的Node.js不能直接生成 .cmd 没有shell的文件。
    • 修复:确保 shell: true 在runner脚本中设置(已包含在上面的脚本中)。
  • 错误: 401 Incorrect API key:
    • 原因1:[.env](file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env)文件的密钥错误。
    • 原因2:[.env](file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env)文件保存为UTF-16(在PowerShell中很常见)。
    • 修复:打开[.env](file:///C:/Users/Mahesh%20Haputhanthiri/.gemini/antigravity/.env)在VS Code中,单击右下角的编码(例如“UTF-16LE”),选择“保存编码”,然后选择“UTF-8”。