prefab-mcp

Prefab용 MCP 서버입니다. 에이전트가 여러분의 템플릿을 확인하고, 원하는 템플릿 하나를 배포해 줄 수 있습니다.

"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 설치와 1회 실행, 그리고 Node 18+ (.mcpb 방법은 제외).

동작 방식

Prefab은 샌드박스 되어 있고 네트워크 접근 권한이 없으므로, 자체적으로 아무것도 호스틱할 수 없습니다. 이 서에서는 Prefab 옆에 실행됩니다. 앱 그룹(~/Library/Group Containers/group.VFDG327 T66.refab)에서 라이브러리를 읽고, Finder 확자인이 사용하는 동일한 prefab:// URL을 통해 앱에 배포를 요청합니다. 알아둬 만한 결과가 두 가지 있습니다:

• 배포하려면 Pre fab이 실해 중이어야 합니다. 읽기는 어느 상황에서든 동작합니다.

• 배포 대상 폴더는 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를 컴파일하여 두 개가를 비교합니다.