Skip to main content
Glama
deenesjakoruzh
ustc-fyk

Antigravity Codex MCP

by ustc-fyk
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Antigravity Codex MCP

一个受控的 Model Context Protocol 桥接器，让 OpenAI Codex 能够按需将工作委托给 Google Antigravity CLI。

该桥接器保持空闲状态，直到用户明确要求 Codex 使用 AGY。随后，它仅授权当前确切的项目，保持项目范围的对话，同步用户可见的对话内容，并将生成的实现更改限制在隔离副本中。

这是一个独立的社区项目。它与 Google 或 OpenAI 没有关联，也未获得其认可。

English

亮点

  • 显式选择加入：除非用户要求，否则 Codex 无法启用或调用 AGY。

  • 精确项目范围：宽泛的根目录和系统目录将被拒绝。

  • 默认只读委托：不授予 AGY 写入、命令、URL 或 MCP 权限。

  • 项目对话：活动对话 ID 和委托历史在 Codex 新任务中得以保留。

  • 可见的对话记录同步：通过 AGY CLI 输入的消息将在下次同步时对 Codex 可用。

  • 私有推理过滤器：在持久化或 MCP 返回之前，会排除思考/推理字段、系统消息和检查点。

  • 隔离实现：经过验证的完整文件替换仅应用于一次性的项目副本。

  • 可审计的运行：响应、更改文件清单、验证输出和经过清理的工具事件均保留在本地。

Related MCP server: codex-agy-bridge

要求

对 Antigravity CLI 进行身份验证，并验证 agy 是否可用：

agy --version
agy -p "Reply exactly: AGY_OK" --output-format json

如果 agy 不在 PATH 中，请在 MCP 配置中将其可执行文件路径设置为 AGY_BIN。

安装

git clone https://github.com/ustc-fyk/antigravity-codex-mcp.git
cd antigravity-codex-mcp
npm ci
npm test

将服务器添加到您的 Codex config.toml 中。将示例路径替换为您机器上的绝对克隆路径：

[mcp_servers.antigravity]
command = 'node'
args = ['C:\path\to\antigravity-codex-mcp\src\index.js']
cwd = 'C:\path\to\antigravity-codex-mcp'
enabled = true
required = false
startup_timeout_sec = 20
tool_timeout_sec = 900
default_tools_approval_mode = 'prompt'
enabled_tools = [
  'antigravity_health',
  'antigravity_project_status',
  'antigravity_enable_project',
  'antigravity_disable_project',
  'antigravity_start_session',
  'antigravity_get_active_session',
  'antigravity_list_sessions',
  'antigravity_sync_conversation',
  'antigravity_get_transcript',
  'antigravity_ask',
  'antigravity_continue',
  'antigravity_review',
  'antigravity_execute',
  'antigravity_list_runs',
  'antigravity_get_run',
]

# Optional when agy is not available on PATH:
[mcp_servers.antigravity.env]
AGY_BIN = 'C:\path\to\agy.exe'

在 macOS 或 Linux 上，使用相应的绝对 POSIX 路径，并且当 agy 在 PATH 中时，通常可以省略 AGY_BIN。

安装随附的 Codex Skill，以便 Codex 遵循选择加入工作流：

$skillRoot = Join-Path $env:USERPROFILE ".codex\skills\agy-project-assistant"
New-Item -ItemType Directory -Force $skillRoot | Out-Null
Copy-Item ".\skills\agy-project-assistant\SKILL.md" $skillRoot

更改 MCP 配置或安装 Skill 后，请重启 Codex。

用法

  1. 在 Codex 中打开任意项目目录。

  2. 正常工作；AGY 桥接器保持空闲状态。

  3. 明确要求：加载 AGY 并审查此项目。

  4. Codex 为该确切项目启用读取访问权限，并启动或重用其 AGY 对话。

  5. Codex 根据情况委托分析、审查、继续或隔离实现。

  6. 要求 为此项目禁用 AGY 以撤销确切的项目权限，同时保留本地审计历史。

要直接检查或参与同一对话：

agy --conversation=<conversation_id>

通过 AGY CLI 发送消息后，要求 Codex 同步 AGY 对话。antigravity_continue 也会在每次后续操作之前和之后进行同步。同步是按需进行的，不是实时推送通道，因此请避免从 Codex 和 AGY CLI 同时发送。

MCP 工具

区域

工具

健康与生命周期

antigravity_health, antigravity_project_status, antigravity_enable_project, antigravity_disable_project

对话

antigravity_start_session, antigravity_get_active_session, antigravity_list_sessions, antigravity_ask, antigravity_continue, antigravity_review

可见的对话记录

antigravity_sync_conversation, antigravity_get_transcript

隔离实现

antigravity_execute, antigravity_list_runs, antigravity_get_run

模型调用仅通过启动、询问、继续、审查和执行工具进行。健康检查、状态、历史记录、运行检查和对话记录同步不消耗 AGY 模型轮次。

项目本地状态

每个启用的项目都会获得一个被忽略的本地状态目录：

.antigravity-mcp/
├── project.json
├── sessions.jsonl
├── transcripts/
│   └── <conversation-id>.jsonl
└── runs/
    └── <run-id>/
        ├── metadata.json
        ├── events.jsonl
        ├── response.md
        └── workspace/

  • project.json 记录选择加入状态和活动对话。

  • sessions.jsonl 记录委托调用和令牌使用情况。

  • transcripts 仅包含可见的用户/助手记录和经过清理的工具跟踪。

  • runs 包含隔离的实现工作区和审计结果。

此目录从源副本中排除，并被 Git 忽略。请勿手动提交，因为它可能包含私有项目或对话数据。

安全模型

项目启用会以原子方式仅将确切根目录添加到 Antigravity trustedWorkspaces 和 read_file(...) 允许规则中。禁用仅会删除这些确切的条目。

隔离实现拒绝：

  • 绝对路径和父目录遍历；

  • 文件删除；

  • 秘密文件、依赖项、构建输出、元数据和符号链接；

  • 超过 50 个更改的文件；

  • 超过 2,000,000 个替换字符。

对话记录管道在写入项目镜像之前，会递归删除私有推理字段，并排除系统/检查点记录。有关报告指南和限制，请参阅 SECURITY.md。

开发

npm ci
npm test
npm run smoke:mcp

实时检查需要经过身份验证的 AGY CLI，并消耗模型配额：

npm run smoke:live
npm run smoke:execute
npm run smoke:project -- "/absolute/path/to/disposable-project"
npm run smoke:continue -- "/absolute/path/to/enabled-project"
npm run smoke:transcript -- "/absolute/path/to/enabled-project"

npm test 是自包含的。smoke:mcp 还会检查本地 AGY 二进制文件，而其余的冒烟测试可能会更改项目授权或消耗配额。

许可证

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • agentmailrooms-mcp

    A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage

  • rtkcontext-mcp

    A paid remote MCP for OpenAI Codex context compressor, built to return verdicts, receipts, usage log

  • byterovermemory-mcp

    A paid remote MCP for OpenAI Codex memory MCP, built to return verdicts, receipts, usage logs, and a

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ustc-fyk/antigravity-codex-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server