修复：「错误：调用「Initialize」：EOF」

如果您正在 Antigravity 中配置自定义 MCP 服务器，很可能遇到过：Error: calling "initialize": EOF。这个错误的技术含义是「我试图与服务器通信，但它立即挂断了。」

什么是 EOF 错误？

EOF（文件结束符）发生于 Antigravity 引擎尝试启动 MCP 服务器进程时，但该进程在来得及说「你好」之前就崩溃了。由于连接提前关闭，引擎在通信线路上看到了「文件结束符」。

修复 0：「逗号」检查

在编辑路径之前，请确保您的 mcp_config.json 是有效的 JSON。单个缺失的逗号或多余的花括号在某些编辑器中会显示为「有效」，但会立即导致 MCP 加载器崩溃。请将您的配置粘贴到 JSON 验证器中进行确认。

修复 1：绝对路径要求

这是 EOF 错误的第一大原因。在您的 mcp_config.json 中，Antigravity 不解析相对路径（如 ./server/index.js）。

• 错误："args": ["node", "./myserver.js"]
• 正确："args": ["node", "/Users/dev/projects/myserver.js"]

请始终使用可执行文件或脚本的完整绝对路径。

修复 2：清除认证令牌和缓存

有时 initialize 调用失败，是因为后台 MCP 进程正在尝试使用过期的 Google 认证令牌。这通常在日志中表现为 Singleflight refresh failed。

精确清理：

根据您的操作系统运行以下命令，强制执行全新的「握手」：

macOS：

Windows：

Linux：

执行后，重启 Antigravity 并重新登录。如果代理仍然失败，请查看我们的代理终止修复指南。

修复 3：Node 环境检查

与您的终端不同，Antigravity 的 MCP 引擎在隔离的 Node.js 环境中运行。它不会自动加载您的 .zshrc、.bash_profile 或 nvm 设置。

这就是绝对路径至关重要的原因。如果您的 MCP 服务器找不到 node 命令，请在 mcp_config.json 中直接指向二进制文件：

正确的 mcp_config.json 示例

以下是经过实战检验、可避免 EOF 错误的配置。从 v1.20.x 起，Antigravity 直接在 mcp_config.json 中支持 ${VAR_NAME} 环境变量替换，因此您无需在文件中硬编码密钥：

${VAR_NAME} 语法在启动时从系统环境中读取值。请在 shell 配置文件（~/.zshrc、~/.bashrc）或通过操作系统密钥链设置这些变量。此模式同样适用于上面显示的 Firebase MCP 条目，该条目在 v1.20.x 中成为官方支持的服务器。

注意（v1.20.5）：当 command 二进制文件无法在 Antigravity 的隔离环境中解析时，EOF 错误在 v1.20.5 中仍然会发生。绝对路径和上述环境变量替换模式仍是权威修复方案。请参阅我们的MCP 安全指南，了解在配置中管理凭据的最佳实践。