공식 웹사이트: https://macos-use.dev/

Swift의 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 주로 MacosUseSDK를 통해 접근성 API를 활용하여 macOS 애플리케이션을 제어할 수 있습니다.

Claude Desktop이나 다른 호환 MCP 클라이언트에서 사용할 수 있습니다.

서버는 표준 입출력(stdio)에서 MCP 명령을 수신하고, 애플리케이션과 상호작용할 수 있는 여러 도구를 노출합니다.

https://github.com/user-attachments/assets/cd203171-bac6-4124-9a58-59947a25be07

https://github.com/user-attachments/assets/f274560a-559f-4140-b133-c0b5c500a02d

사용 가능한 도구

서버는 CallTool MCP 메서드를 통해 다음과 같은 도구들을 노출합니다:

1. macos-use_open_application_and_traverse

• 설명: 지정된 애플리케이션을 열거나 활성화한 후 그 접근성 트리를 탐색합니다.
• 매개변수:
• identifier (문자열, 필수): 애플리케이션의 이름, 번들 ID, 또는 파일 경로.

2. macos-use_click_and_traverse

• 설명: 대상 애플리케이션 창(PID로 식별됨)에서 마우스 클릭을 시뮬레이션한 후 접근성 트리를 탐색합니다.
• 매개변수:

mcp-server-macos-use

Official website: https://macos-use.dev/

Model Context Protocol (MCP) server in Swift. It allows controlling macOS applications by leveraging the accessibility APIs, primarily through the MacosUseSDK.

You can use it in Claude Desktop or other compatible MCP-client.

The server listens for MCP commands over standard input/output (stdio) and exposes several tools to interact with applications.

https://github.com/user-attachments/assets/cd203171-bac6-4124-9a58-59947a25be07

https://github.com/user-attachments/assets/f274560a-559f-4140-b133-c0b5c500a02d

Available Tools

The server exposes the following tools via the CallTool MCP method:

1. macos-use_open_application_and_traverse

   • Description: Opens or activates a specified application and then traverses its accessibility tree.
   • Parameters:
     • identifier (String, Required): The application’s name, bundle ID, or file path.

2. macos-use_click_and_traverse

   • Description: Simulates a mouse click at specific coordinates within the window of the target application (identified by PID) and then traverses its accessibility tree.
   • Parameters:
     • pid (Number, Required): The Process ID (PID) of the target application.
     • x (Number, Required): The X-coordinate for the click (relative to the window/screen, depending on SDK behavior).
     • y (Number, Required): The Y-coordinate for the click.

3. macos-use_type_and_traverse

   • Description: Simulates typing text into the target application (identified by PID) and then traverses its accessibility tree.
   • Parameters:
     • pid (Number, Required): The Process ID (PID) of the target application.
     • text (String, Required): The text to be typed.

4. macos-use_press_key_and_traverse

   • Description: Simulates pressing a specific keyboard key (e.g., ‘Enter’, ‘Tab’, ‘a’, ‘B’) with optional modifier keys held down, targeting the application specified by PID, and then traverses its accessibility tree.
   • Parameters:
     • pid (Number, Required): The Process ID (PID) of the target application.
     • keyName (String, Required): The name of the key (e.g., Return, Escape, ArrowUp, Delete, a, B). Case-sensitive for letters if no modifiers are active.
     • modifierFlags (Array, Optional): An array of modifier keys to hold during the press. Valid values: CapsLock (or Caps), Shift, Control (or Ctrl), Option (or Opt, Alt), Command (or Cmd), Function (or Fn), NumericPad (or Numpad), Help.

5. macos-use_refresh_traversal

   • Description: Only performs the accessibility tree traversal for the specified application (identified by PID). Useful for getting the current UI state without performing an action.
   • Parameters: