Agentbridge

Name: Agentbridge
Author: SeanFDZ

@SeanFDZ

代码仓库主页

关于 Agentbridge

Let AI agents control Classic Mac OS through a shared folder protocol.

#classic-mac #retro-computing #macos #hardware #68k #powerpc #file-protocol

基本信息

分类

其他

许可证

GPL-3.0

运行时

传输方式

stdio

发布者

SeanFDZ

提交者

Sean Lavigne

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "classic-mac": {
      "command": "node",
      "args": [
        "/path/to/mcp-server/dist/server.js",
        "--config",
        "/path/to/fleet.json"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is AgentBridge?

AgentBridge is a native Classic Mac OS application that lets AI agents (like Claude) interact with Mac OS 7–9 through structured commands and responses. It uses a shared folder for transport, works on real hardware and emulators, and requires no modifications to the Classic Mac.

How to use AgentBridge?

Install the MCP server via npm (npm install -g classic-mac-mcp) or run with npx, create a fleet.json configuration file pointing to the shared folder, then launch AgentBridge on the Classic Mac. AI agents can then send commands (e.g., ping) via files in the inbox, and AgentBridge writes responses to the outbox.

Key features of AgentBridge

No modifications required to the Classic Mac System.
List and control windows, processes, and menus.
Mouse and keyboard input (click, drag, type, key press).
Clipboard read/write operations.
Launch, activate, and quit applications via Apple Events.
Browse files and volumes on the Mac.
Supports multiple Classic Mac targets simultaneously.

Use cases of AgentBridge

Automate tasks on a vintage Mac from a modern AI assistant.
Test or interact with retro software without manual input.
Retrieve system information and clipboard contents from a Classic Mac.
Control emulators like BasiliskII or SheepShaver programmatically.

FAQ from AgentBridge

What transport does AgentBridge use?

AgentBridge uses a shared folder as its transport. Commands are written to an inbox folder, and responses are read from an outbox folder. The folder can be on a NAS, emulator host directory, or any shared filesystem both sides can access.

Which Classic Mac OS versions are supported?

AgentBridge requires System 7.0 or later (for Apple Events support). It has been tested on System 7.6.1 (68k) and builds for PowerPC Mac OS 8.5–9.2.2.

Can I control multiple Classic Macs with one MCP server?

Yes. Each Mac gets its own subfolder (e.g., AgentBridge-SE30) with its own inbox/outbox/assets. The MCP server’s fleet.json configuration can list multiple targets, and tools accept an optional target parameter.

Do I need to modify the Classic Mac’s system?

No. AgentBridge is a regular application — launch it, quit it, done. No SSH, drivers, or system extensions are required.

What MCP tools are available?

The server exposes tools for system status (ping, heartbeat, system info), windows/processes, menus, mouse/keyboard, clipboard, application control, and file/volume browsing. A full list is in the MCP Tools Reference section of the README.