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.