DesktopBridge 🌉

macOS 向けローカル Model Context Protocol サーバー。Claude（または任意の MCP ホスト）が stdio 経由で通信し、以下が可能です:

• 許可されたディレクトリ内のファイルの読み取り、書き込み、一覧表示、検索

• CPU / メモリ / ディスク統計、稼働時間、および編集された環境変数の読み取り

• 実行中のアプリケーションの一覧表示

• stdout/stderr を分離したシェルコマンドの実行、タイムアウト、オプションの進捗ストリーミング

• クリップボードの読み書き

• スクリーンショットの取得とディスプレイの一覧表示

このプロセスは、起動したユーザーと同じ OS 権限を持ちます。モデルに Mac のターミナルを与えるようなものだと考え、DESKTOP_BRIDGE_ROOTS で影響範囲を縮小してください。

要件

• macOS（クリップボード、スクリーンショット、アプリケーション一覧は Apple のツールを使用）

• Node.js 20.19+（22 LTS 推奨）

Related MCP server: macOS Automator MCP Server

インストール

cd desktop-bridge
npm install
npm run build
npm test

コンパイル済みエントリポイントは dist/index.js です。

Claude Desktop に接続

1. サーバーをビルドします（npm run build）。

2. Claude Desktop → Settings → Developer → Edit Config を開きます。

3. claude_desktop_config.example.json のブロックをマージし、パスとユーザー名を置き換えます:

{
  "mcpServers": {
    "desktop-bridge": {
      "command": "node",
      "args": ["/Users/YOU/dev/desktop-bridge/dist/index.js"],
      "env": {
        "DESKTOP_BRIDGE_ROOTS": "/Users/YOU/Desktop,/Users/YOU/Documents,/Users/YOU/Downloads"
      }
    }
  }
}

4. Claude Desktop を完全に終了して再起動します。

5. MCP ツール（ブリッジアイコン 🌉）に desktop-bridge が表示されることを確認します。

macOS の設定ファイル:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code に接続

claude mcp add desktop-bridge -- node /Users/YOU/dev/desktop-bridge/dist/index.js

または、同じ command / args / env ブロックを ~/.claude.json に追加します。

Cursor に接続

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します:

{
  "mcpServers": {
    "desktop-bridge": {
      "command": "node",
      "args": ["/Users/YOU/dev/desktop-bridge/dist/index.js"]
    }
  }
}

ホストなしでスモークテスト

npm run inspector

これにより、ビルド済みの stdio サーバーに対して MCP Inspector が起動します。list_roots を呼び出し、次に get_system_info を呼び出します。

ログは stderr のみに出力されます。このプロセスで console.log を使用しないでください — stdout は JSON-RPC チャネルです。

環境変数

コメント付きテンプレートは .env.example をコピーしてください。サーバーは プロセス環境変数（Claude Desktop の env ブロック）を読み取ります。.env ファイルは読み取りません。

ツール

リソース: desktop://roots, desktop://system/info。
プロンプト: inspect_desktop, find_file。

セキュリティモデル

• ファイル: すべてのパスは realpath で解決されます。解決されたパスは設定されたルート内に存在する必要があります。..、余分なスラッシュ、ルートを外れるシンボリックリンクは拒否されます。

• ホームはデフォルトのルートではありません。 これにより、~/.ssh などは意図的に追加しない限りアクセスできません。

• シェル: 依然として完全なユーザーシェルです。cwd が制限されていても、コマンドは任意の場所に cd できます。ファイル/クリップボード/スクリーンツールのみが必要な場合は、DESKTOP_BRIDGE_ALLOW_SHELL=false で無効にしてください。

• 環境変数: password/token/secret/key/credential/cookie/session に一致するキーは [redacted] に置き換えられます。

• Stdio: ネットワークリスナーはありません。ホストがこのプロセスを起動します。

macOS の権限

screencapture が失敗する場合は、システム設定 → プライバシーとセキュリティ → 画面収録 を開き、ホストアプリを有効にしてから再起動してください。

開発

npm run build    # tsc → dist/
npm start        # node dist/index.js (stdio)
npm test         # compile + node:test

レイアウト: src/lib/*（パスガード、プロセスランナー、グロブ/検索）、src/tools/*（MCP ツール）、src/index.ts（stdio エントリ）。

ホーム

https://home.jameymcelveen.com はブラウザのスタートページです（web/、追加の npm パッケージなし）。サインインは @mcelveen.us と STATUS_PASSWORD です。

現在の内容と、今後追加されるもののダンプトレイ:

Chrome/Safari/Firefox のホームページを https://home.jameymcelveen.com に設定してください（ブラウザがページから自動設定することはできません）。セッション Cookie は 30 日間有効です。/ で検索にフォーカス、⌘K も同様です。

main へのプッシュで CI が実行され、その後 Vercel（サイト）と Railway（ハートビート + 保存設定）にデプロイされます。

Mac では、MCP サーバーの env に追加します:

DESKTOP_BRIDGE_STATUS_URL=https://home.jameymcelveen.com/api/heartbeat
DESKTOP_BRIDGE_STATUS_TOKEN=<HEARTBEAT_TOKEN>

ライセンス

MIT