agentbridge — Claude Code MCP server: what it does, how to install
Connects AI assistants to Classic Mac OS 7–9 environments via shared folder files. Handles menus, windows, and input on hardware or emulators.
claude mcp add agentbridge -- npx -y classic-mac-mcpWhat agentbridge 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.
What it helps with
- 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 for the agent
- 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.
How to install agentbridge
Platform CLI
claude mcp add agentbridge -- npx -y classic-mac-mcpPlatform CLI
codex mcp add agentbridge -- npx -y classic-mac-mcpConfig file
{
"mcpServers": {
"agentbridge": {
"command": "npx",
"args": [
"-y",
"classic-mac-mcp"
]
}
}
}Config file
{
"servers": {
"agentbridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"classic-mac-mcp"
]
}
}
}Platform CLI
gemini mcp add agentbridge npx -y classic-mac-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about agentbridge
How do I install agentbridge in Claude Code?
Run claude mcp add agentbridge -- npx -y classic-mac-mcp in your environment. Launch the AgentBridge application inside your Classic Mac OS shared directory to begin processing commands.
What does agentbridge do?
It lets an AI assistant control Classic Mac OS 7–9 systems through text queues on a shared filesystem. The agent inspects windows, manages clipboard data, and triggers mouse or keyboard events.
Does the vintage Mac need an active internet connection?
No internet access or system modifications are needed on the Mac. The setup only requires a shared volume via SMB, AFP, or an emulator host directory.
