prefab-mcp

Prefab 用のMCPサーバーです。エージェントがあなたのテンプレートを確認し、その1つをデプロイできるようにします。

"Set up a new client folder for Northwind, autumn campaign, on my Desktop"

公開するもの

Related MCP server: macOS Companion MCP Server

セットアップ

stdio で MCP を話すクライアントならどれでも動作します。

バンドルとして - リリースページ から prefab.mcpb をダウンロードしてダブルクリックします。MCP バンドルをインストールするクライアント(Claude Desktop など)は Node を同梱しているので、追加でインストールするものはありません。

コマンドラインから (Claude Code、および同じ発想のクライアント):

claude mcp add prefab -- npx -y prefab-mcp

設定ファイルで - Cursor、Zed、およびその他大半のクライアント:

{
  "mcpServers": {
    "prefab": { "command": "npx", "args": ["-y", "prefab-mcp"] }
  }
}

次に、Prefab の「設定 ▸ 権限」で 「エージェントとスクリプトによる Prefab の制御を許可」 をオンにします。初期設定ではオフで、オフのままでもテンプレートの読み取りは可能ですが、作成とデプロイはできません。

このスイッチが使えるのは Prefab 1.1.6 からです。それ以前のバージョンでは、読み取り系ツールは動作し、それ以外のツールはその旨を表示します。

要件: macOS、インストール済みで一度は起動した Prefab、Node 18+(.mcpb の方法は除く)。

仕組み

Prefab はサンドボックス化されておりネットワークアクセスがないため、何かをホストすることはできません。このサーバーはその代わりに、Prefab の隣で動作します。アプリグループ (~/Library/Group Containers/group.VFDG327T66.prefab) からライブラリを直接読み取り、Finder 拡張機能が使うのと同じ prefab:// URL を通してアプリにデプロイを依頼します。これによって生じる注意点が2つあります:

• デプロイには Prefab が起動している必要があります。読み取りはどちらの場合でも動作します。

• デプロイ先は、Prefab がアクセスを許可されたフォルダである必要があります。サンドボックス化されたアプリは、フォルダを指定して許可するまで、あなたのフォルダにアクセスできません。エージェントが答えられない権限ダイアログを画面に残す代わりに、preview_deploy と deploy_template は両方とも先にチェックして、その旨を表示します。フォルダの許可は、Prefab の「設定 ▸ 権限」で与えてください。

このサーバーが Prefab のライブラリに書き込むことはありません。それらのファイルはアプリが所有しており、背後から編集しても、次回保存時に上書きされてしまいます。

開発

npm test    # checks placeholder resolution matches the app's Swift, case for case
npm run try '[["list_templates",{}]]'    # call a tool the way a client does

src/resolve.js は RenamePattern.swift を意図的に複製したものです。どちらかを変更したら、もう一方も変更してください - npm test は Swift をコンパイルして両者を比較します。