ada20204 antigravity-mcp
Use the local Antigravity MCP server for lightweight asks, workspace inspection, and image generation.
Features
- 🔌 Direct MCP Connection - Connects directly to antigravity-mcp-server
- 🖼️ Image Generation - Generate images via Antigravity AI
- 📊 Code Analysis - Analyze project code and architecture
- 🔄 Async Support - Full asyncio implementation
- 🛡️ Error Handling - Comprehensive error handling and logging
Prerequisites
# 1. Antigravity MCP Server must be installed
ls ~/.config/antigravity-mcp/bin/antigravity-mcp-server
# 2. Python 3.8+ with asyncio
python3 --version # >= 3.8
Installation
# Skill is automatically discovered by OpenClaw
# Place in: ~/.agents/skills/antigravity-mcp/
# Verify installation
openclaw skills list | grep antigravity
Usage
Command Line
# Ping MCP server
python3 ~/.agents/skills/antigravity-mcp/scripts/antigravity_cli.py ping
# List available tools
python3 ~/.agents/skills/antigravity-mcp/scripts/antigravity_cli.py list-tools
# List known workspaces (prefers local registry)
python3 ~/.agents/skills/antigravity-mcp/scripts/antigravity_cli.py list-workspaces
# Check quota
python3 ~/.agents/skills/antigravity-mcp/scripts/antigravity_cli.py quota-status
# Ask Antigravity to generate/analyze
python3 ~/.agents/skills/antigravity-mcp/scripts/antigravity_cli.py ask \
"生成一张太空猫咪的图片，穿着宇航服，背景是地球和星空"
# Specify output path for image tasks
python3 ~/.agents/skills/antigravity-mcp/scripts/antigravity_cli.py ask \
"画一只可爱的猫" -o ~/Desktop/cat.png
As OpenClaw Tool
# In an OpenClaw conversation or script
from antigravity_mcp import AntigravityMCPClient
client = AntigravityMCPClient()
await client.connect()
# Generate image
result = await client.ask_antigravity(
"生成一张架构图，展示微服务系统的数据流",
output_path="/tmp/architecture.png"
)
await client.disconnect()
Available Actions
| Action | Description | Example |
|---|---|---|
ask-antigravity |
Send prompt to Antigravity AI | Generate images, analyze code, answer questions |
antigravity-stop |
Stop running generation | Cancel long-running tasks |
ping |
Test connectivity | Check if server is ready |
list-workspaces |
List available workspaces | See available project contexts |
quota-status |
Check quota | Verify usage limits |
launch-antigravity |
Launch Antigravity | Start Antigravity with CDP |
Architecture
┌─────────────────────────────────────────────┐
│ OpenClaw Agent / CLI │
└──────────────────┬──────────────────────────┘
│
┌──────────────────▼──────────────────────────┐
│ antigravity-mcp Skill (Python/Asyncio) │
│ ┌─────────────────────────────────────┐ │
│ │ AntigravityMCPClient │ │
│ │ ├─ connect() │ │
│ │ ├─ ask_antigravity() │ │
│ │ ├─ list_tools() │ │
│ │ └─ disconnect() │ │
│ └─────────────────────────────────────┘ │
└──────────────────┬──────────────────────────┘
│ stdio (JSON-RPC)
┌──────────────────▼──────────────────────────┐
│ antigravity-mcp-server (binary) │
└──────────────────┬──────────────────────────┘
│ CDP / WebSocket / HTTP
┌──────────────────▼──────────────────────────┐
│ Antigravity AI Service │
│ (Image Generation, Code Analysis, etc.) │
└─────────────────────────────────────────────┘
Troubleshooting
Server not found
# Check if antigravity-mcp is installed
ls ~/.config/antigravity-mcp/bin/antigravity-mcp-server
# If not found, install Antigravity app first
# (Antigravity should install MCP server automatically)
Connection timeout
# Check if server is already running
ps aux | grep antigravity-mcp-server
# Check logs
tail ~/.config/antigravity-mcp/logs/latest.log
Image generation fails
- Verify Antigravity app has necessary permissions
- Check quota status: use
quota-statusaction - Ensure prompt is not blocked by safety filters
Contributing
This Skill is designed to be:
- Modular: Easy to extend with new actions
- Maintainable: Clear error handling and logging
- Compatible: Works with OpenClaw ecosystem
License
MIT - OpenClaw Agent