mcps-for-macos

macOS 자동화를 위한 MCP 서버(Model Context Protocol) 모음입니다. 각 서버는 AppleScript 또는 명령줄을 통해 앱 또는 시스템 기능을 캡슐화하고, AI 애플리케이션(Claude Desktop, Claude Code)이 호출할 수 있는 도구로 제공합니다.

공통 헬퍼(이스케이프 처리를 포함한 AppleScript 실행, 명령 실행)는 packages/common에 있으며 서버에서 @mcps/common으로 사용됩니다.

MCP 서버란 무엇인가?

MCP는 AI 애플리케이션(호스트)이 외부 도구 및 데이터와 통신하는 개방형 표준입니다. 서버는 기능(도구)을 제공하며 AI 자체에 대해서는 알지 못합니다. JSON-RPC 2.0을 통한 통신, 여기서는 stdio(로컬 프로세스)를 사용합니다. 등록이란 호스트에 서버를 시작하는 방법을 알려주는 것입니다. 호스트는 세션이 시작될 때마다 서버를 하위 프로세스로 시작하고, 도구를 조회하여 AI에 제공합니다.

Related MCP server: macos-mcp-tools

설치

npm install

루트 디렉터리에서 npm install 한 번이면 모든 서버에 충분합니다(npm workspaces). 빌드 단계 없음: 순수 ESM JavaScript, Node >= 18.

등록

각 서버는 별도의 프로세스이므로 개별적으로 등록됩니다. 경로는 절대 경로로 지정해야 합니다. <REPO>는 이 저장소의 경로를 나타냅니다.

Claude Code

# global in allen Projekten (empfohlen für Systemwerkzeuge)
claude mcp add apple-calendar --scope user -- node <REPO>/packages/apple-calendar/src/index.js
claude mcp add apple-mail  --scope user -- node <REPO>/packages/apple-mail/src/index.js
claude mcp add money-money --scope user -- node <REPO>/packages/money-money/src/index.js
claude mcp add spotlight   --scope user -- node <REPO>/packages/spotlight/src/index.js

--scope user가 없으면 등록은 현재 프로젝트에만 적용됩니다. 확인 및 제거:

claude mcp list
claude mcp remove spotlight

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json에서:

{
  "mcpServers": {
    "apple-calendar": { "command": "node", "args": ["<REPO>/packages/apple-calendar/src/index.js"] },
    "apple-mail":  { "command": "node", "args": ["<REPO>/packages/apple-mail/src/index.js"] },
    "money-money": { "command": "node", "args": ["<REPO>/packages/money-money/src/index.js"] },
    "spotlight":   { "command": "node", "args": ["<REPO>/packages/spotlight/src/index.js"] }
  }
}

macOS 권한

• 자동화. 첫 번째 접근 시 macOS가 Mail, 캘린더 또는 MoneyMoney에 대한 자동화 접근 권한을 요청합니다. 한 번 허용하세요.

• 전체 디스크 접근. 보호된 위치(예: ~/Library/Mail)는 실행 중인 프로세스에 전체 디스크 접근 권한이 있어야만 결과를 반환합니다(시스템 설정 → 개인정보 보호 및 보안 → 전체 디스크 접근 권한).

로컬 테스트

각 서버를 MCP Inspector로 개별적으로 클릭하여 테스트:

npm run inspect -w @mcps/spotlight

라이선스

MIT