agymcp

将 Antigravity CLI (agy) 包装为 MCP Server，供 Claude Code 等支持 MCP 协议的客户端调用。

前置条件

• Antigravity CLI 已安装并完成登录（agy 命令在 PATH 中可用）

• uv 已安装（用于 uvx 拉取运行）

• Python 3.10 或更高版本

Related MCP server: antigravity-cli-mcp

安装

在 ~/.claude.json 的 mcpServers 中添加：

{
  "mcpServers": {
    "agy": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/leologoli/agymcp.git",
        "agymcp"
      ],
      "env": {},
      "type": "stdio"
    }
  }
}

重启 Claude Code 后生效，首次启动会自动拉取安装依赖。

工具说明

agy

调用 Antigravity CLI 执行 AI 任务，返回模型回复文本和会话 ID。

参数：

返回：

示例：

// 新建会话
{
  "PROMPT": "用一句话介绍你自己",
  "cd": "/path/to/project"
}

// 续话
{
  "PROMPT": "我上一条问你什么了？",
  "cd": "/path/to/project",
  "SESSION_ID": "56540478-7163-4d90-a476-f2487c81aa6a"
}

实现原理

1. 以 --print 模式运行 agy，通过 --log-file 将日志写入临时文件

2. 从日志中正则提取 conversation UUID 作为 SESSION_ID

3. 续话时通过 --conversation <SESSION_ID> 参数恢复上下文

4. 基于 MCP Python SDK 2.x 的 MCPServer 实现 stdio 传输

MCP SDK 兼容性

agymcp 0.2.x 支持 MCP Python SDK 2.x（mcp>=2.0.0,<3），不再兼容 MCP 1.x。

License

MIT