Antigravity Terminal MCP

反重力终端MCP

以Windows为中心的MCP服务器，用于终端自动化，具有持久会话和实时会话日志。 由AATHI创建。

特性

• 持久PowerShell会话(session_id，默认值： default)
• 增量 stdout/stderr 轮询
• 向正在运行的会话发送后续输入
• 为每个会话返回实时日志文件路径
• 可通过以下方式配置监控模式 ANTIGRAVITY_MONITOR_MODE
• 每个会话返回的VS Code集成终端元数据
• MCP标准方法(tools/list, tools/call)使用旧别名

MCP工具

1. run_command
2. command_status
3. send_input
4. list_sessions
5. session_visual_info
6. kill_command

Publish-Ready One命令用法（来自GitHub）

将此项目推送到GitHub后，用户可以使用以下命令无缝安装并将其附加到Claude uvx （或更坚固的 python -m uv Windows的变体）：

# Standard uvx (if in PATH)
claude mcp add antigravity-terminal-mcp uvx --from git+https://github.com/aathishwar-13/antigravity-terminal-mcp.git antigravity-terminal-mcp

# More robust Windows version (if uvx is not in PATH)
claude mcp add antigravity-terminal-mcp python -m uv tool run --from git+https://github.com/aathishwar-13/antigravity-terminal-mcp.git antigravity-terminal-mcp

*（注意：如果代码嵌套在子目录中，只需追加 #subdirectory=folder_name 到git URL）。*

本地跑

uvx --from . antigravity-terminal-mcp

或

python server.py

监视器模式

默认情况下，服务器不会打开外部监视器窗口(ANTIGRAVITY_MONITOR_MODE=none). 当您使用集成终端网桥时，这会在VS Code中保持监控。

如果您明确希望每个会话监视器都有一个单独的PowerShell窗口，请启用外部模式：

$env:ANTIGRAVITY_MONITOR_MODE = "external"
python server.py

要强制不使用外部监视器窗口，请执行以下操作：

$env:ANTIGRAVITY_MONITOR_MODE = "none"
python server.py

当 run_command 或 session_visual_info 调用后，响应现在包括：

• log_path
• watch_command
• monitor_mode
• vscode_terminal
• monitor_open （可点击/打开操作的快速打开元数据）

monitor_open 包括：

• command_uri （VS代码命令URI antigravityTerminal.openMonitor)
• markdown_link （聊天用户界面的预建可点击标记链接）
• integrated_terminal_command （复制/粘贴命令以在集成终端中打开实时监视器）
• open_terminal_uri （打开VS Code集成终端）
• open_terminal_with_cwd_uri （在会话cwd中打开集成终端）
• run_in_active_terminal_uri （在活动集成终端中运行监控命令）

这 vscode_terminal 该对象专为VS Code扩展而设计，用于在集成终端内打开相同的会话监视器。

VS代码集成终端桥

一种轻质的延伸脚手架 vscode-integration/.

它做什么

• 在当前的VS Code窗口中打开集成的PowerShell终端
• 运行返回 watch_command / vscode_terminal.command
• 允许您粘贴完整 session_visual_info JSON或只是 log_path
• 显示状态栏按钮： MCP Monitor （右下角）选择并打开任何现有的会话监视器
• 自动检测 session_logs/*.log 创建/更改活动并显示 Open Monitor 弹出操作

如何在当地尝试

1. 打开 antigravity_mcp/vscode-integration 在VS代码中。
2. 按 F5 启动扩展主机。
3. 跑 Antigravity: Open Monitor From Session Info JSON 从命令选项板。
4. 粘贴返回的JSON session_visual_info 或 run_command.

点击何处

• 右下角VS代码状态栏：点击 MCP Monitor 并选择一个会话
• 创建新会话时：单击 Open Monitor 在弹出通知中

这使用VS代码扩展API，这是在当前编辑器窗口中打开集成终端的正确方式。一个普通的Python进程不能自己直接在VS Code中创建终端选项卡。

快速集成监控命令（无复制/粘贴）

使用VS Code集成终端中的辅助脚本：

Set-Location d:\Projects\Client_projects\Velyx_Chatbot\antigravity_mcp
.\open-monitor.ps1 -SessionId live-agent

当前终端会话的可选短别名：

Set-Alias agmwatch .\open-monitor.ps1
agmwatch -SessionId live-agent

这将保持对VS Code内部的监控，并且不会打开外部终端窗口。

MCP配置示例

{
  "mcpServers": {
    "antigravity-terminal-mcp": {
      "command": "python",
      "args": [
        "-m",
        "uv",
        "tool",
        "run",
        "--from",
        "git+https://github.com/aathishwar-13/antigravity-terminal-mcp.git",
        "antigravity-terminal-mcp"
      ]
    }
  }
}

或

{
  "mcpServers": {
    "antigravity-terminal-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/AATHI/antigravity-terminal-mcp.git",
        "antigravity-terminal-mcp"
      ]
    }
  }
}

______________________________________________________________________

👨‍💻 关于作者

AATHI 是一家专注于为下一代人工智能代理构建高性能、以开发人员为中心的自动化工具的开发人员。AATHI专门致力于弥合无头LLM执行和丰富的面向用户的终端交互之间的差距，创建了这个工具，以提供超越标准VS Code集成限制的便携式专业终端体验。

请随时通过此存储库寻求反馈或技术支持！