I
io.github.SeanFDZ/agentbridge
Control Classic Mac OS (System 7-9) from AI agents via shared folder protocol.
ActiveNot tested
55CNo CVEsactive
Quick Install
{
"mcpServers": {
"classic-mac": {
"args": [
"/path/to/agentbridge/dist/server.js",
"--config",
"/path/to/agentbridge/config/fleet.json"
],
"command": "node"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/io-github-seanfdz-agentbridge)
Should you use this server?
Control Classic Mac OS (System 7-9) from AI agents via shared folder protocol.
✓
Is it safe?
No known CVEs for classic-mac-mcp.
No authentication — any process on your machine can connect.
License not specified.
✓
Is it maintained?
Last commit 3 days ago. 18 stars.
i
Will it work with my client?
Transport: stdio, sse, http. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
README
AgentBridge
Let AI talk to your Classic Mac.
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 works on real hardware and emulators — no modifications to your Mac required.
Drop AgentBridge into a shared folder, launch it on your Mac, and an AI agent can list windows, open apps, type text, read the clipboard, browse files, and more — all through a simple text-based protocol.
How It Works
┌──────────────────────┐
│ Claude / AI Agent │
│ │ │
│ MCP Protocol │
│ │ │
│ MCP Server (Node) │
│ │ │
│ Shared Folder I/O │
└────────┬─────────────┘
│ reads/writes text files
│
┌────┴──────────────────────────┐
│ Shared Volume (NAS / AFP / │
│ SMB / emulator extfs) │
│ │
│ AgentBridge-MyMac/ │
│ ├── inbox/ ← commands in │
│ ├── outbox/ ← responses out │
│ ├── assets/ ← file staging │
│ └── heartbeat │
└────┬──────────────────────────┘
│
┌────────┴─────────────────────────┐
│ Classic Mac OS 7 / 8 / 9 │
│ │
│ AgentBridge.app │
│ - Polls inbox for commands │
│ - Executes via Mac Toolbox │
│ - Writes responses to outbox │
│ - Heartbeat every 2 seconds │
└──────────────────────────────────┘
The transport is just a folder. How that folder is shared between the AI and the Mac is up to you:
- NAS/file server (AFP or SMB) — multiple Macs and your modern computer all mount the same share
- Emulator shared folder — BasiliskII and SheepShaver both support host directory sharing
- Any other shared filesystem — if both sides can read and write files, it works
No SSH. No special drivers. No modifications to your Mac's system. AgentBridge is a regular application — launch it, quit it, done.
MCP Tools Reference
The MCP server exposes these tools to AI agents. If the fleet has only one target, the target parameter is optional on all tools.
System & Status
classic_mac_list_targets
List all configured Classic Mac targets and their status (heartbeat alive/dead).
No parameters.
classic_mac_ping
Health check — returns pong if AgentBridge is responding.
| Parameter | Required | Description |
|---|---|---|
target | No | Target ID or alias |
classic_mac_heartbeat
Read the heartbeat file — shows uptime, front app, free memory, timestamp.
| Parameter | Required | Description |
|---|---|---|
target | No | Target ID or alias |
classic_mac_get_about
System information — OS version, machine type, RAM, free memory, uptime.
| Parameter | Required | Description |
|---|---|---|
target | No | Target ID or alias |
Windows & Processes
classic_mac_list_windows
Enumerate all visible windows across all applications. Returns window index, title, bounds (left,top,right,bottom), and front/back layer.
| Parameter | Required | Description |
|---|---|---|
target | No | Target ID or alias |
classic_mac_get_front_window
Get details about the frontmost window — title, bounds, owning app.
| Parameter | Required | Description |
|---|---|---|
target | No | Target ID or alias |
classic_mac_list_processes
List running applications with name, creator code, PID, and memory partition.
Test This Server
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'classic-mac-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Help improve this page
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationScore Breakdown
Security
20/30No known vulnerabilities.
✓
○
Tool safety — No tools to analyze
○
Tool poisoning — No tools to analyze
○
Injection vectors — No tools to analyze
✓
Tool stability — Tool definitions stable
○
Dependency health — found on deps.dev, recently updated
✗
License — No license specified
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is io.github.SeanFDZ/agentbridge safe to use?
- io.github.SeanFDZ/agentbridge has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
- How do I install io.github.SeanFDZ/agentbridge?
- io.github.SeanFDZ/agentbridge supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
- What AI clients work with io.github.SeanFDZ/agentbridge?
- io.github.SeanFDZ/agentbridge is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio and sse and http transport.
- Is io.github.SeanFDZ/agentbridge actively maintained?
- io.github.SeanFDZ/agentbridge is actively maintained — last commit was 3 days ago. It has 18 GitHub stars.
Similar servers
View all →
Sequential Thinking MCP Server
OfficialNo CVEs98A
Dynamic problem-solving through sequential thought chains
1 toolsstdio83.8k111.0k/wk1d ago
XcodeBuildMCP
OfficialNo CVEs97A
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
2 toolsremote5.2k46.6k/wk1d ago
Python Sdk
OfficialNo CVEs95A
The official Python SDK for Model Context Protocol servers and clients
1 toolsremote22.6k156.5k/wk21h ago
Gemini Cli
No CVEs95A
An open-source AI agent that brings the power of Gemini directly into your terminal.
8 toolsremote101.3k814.6k/wk12h ago
MCP Security Weekly
Get CVE alerts and security updates for io.github.SeanFDZ/agentbridge and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.