# agentbridge

Connects AI assistants to Classic Mac OS 7–9 environments via shared folder files. Handles menus, windows, and input on hardware or emulators.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27
- Author: SeanFDZ
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SeanFDZ/agentbridge
- Updated: 2026-04-20
- HTML: https://affpapa.org/en/nevibecode/mcp/agentbridge

## What it does

AgentBridge connects coding agents to vintage Apple hardware or emulators such as BasiliskII and SheepShaver. The setup requires no system extensions or terminal daemons on the vintage machine. A standalone Mac program checks a shared directory inbox for task directives and writes back answers.

The Node runtime delivers standard tools for Mac Toolbox manipulation. AI models query visible application windows, inspect active processes, read clipboard text, and trigger mouse drags or key combinations. Every 2 seconds the client writes a heartbeat with free RAM metrics. Communication breaks immediately if the host drops the file mount.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agentbridge -- npx -y classic-mac-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add agentbridge -- npx -y classic-mac-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentbridge": {
            "command": "npx",
            "args": [
                "-y",
                "classic-mac-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentbridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "classic-mac-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agentbridge npx -y classic-mac-mcp
```

## When to use it
- inspect running processes and window coordinates on System 7 to 9
- trigger mouse movements, drags, and clicks on vintage screens
- trigger application menu actions by title
- read and paste text via the vintage system clipboard

## Example prompts
- List all visible windows on the target Mac and identify the front one.
- Send a double click to coordinates 120, 240.
- Retrieve the current text contents from the classic Mac clipboard.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md