MCP Server Macos Use

🚀 macOS 使用 MCP 服務器

本項目的模型上下文協議（MCP）服務器採用 Swift 編寫，它藉助 MacosUseSDK，允許通過 Accessibility API 控制 macOS 應用程序。你可以將其與 Claude Desktop 或其他兼容的 MCP 客戶端搭配使用。該服務器通過標準輸入/輸出（stdio）監聽 MCP 命令，還提供了多種工具用於與應用程序進行交互。

GitHub 資產鏈接

🚀 快速開始

構建與運行

要構建和運行服務器，請執行以下命令：

swift build

然後運行：

./mcp-server-macos-use/.build/debug/mcp-server-macos-use

集成示例

若要在配置文件中指定 MCP 服務器的位置，以 Claude Desktop 為例：

{
    "mcpServers": {
        "mcp-server-macos-use": {
            "command": "/path/to/your/project/mcp-server-macos-use/.build/debug/mcp-server-macos-use"
        }
    }
}

請將 /path/to/your/project/ 替換為你項目的真實絕對路徑。

✨ 主要特性

• 通過 Accessibility API 控制 macOS 應用程序。
• 支持與 Claude Desktop 等兼容的 MCP 客戶端配合使用。
• 提供多種工具與應用程序交互。

📦 安裝指南

本項目依賴 MacosUseSDK，它是一個用於與 macOS 應用程序交互的本地或外部 Swift 包。

💻 使用示例

可用工具

通過 CallTool MCP 方法，服務器提供了以下工具：

1. macos-use_open_application_and_traverse
   • 描述：打開或激活指定應用程序，然後遍歷其訪問性樹。
   • 參數：
     • identifier (String, 必填)：應用程序的名稱、bundle ID 或文件路徑。
2. macos-use_click_and_traverse
   • 描述：在目標應用程序（由 PID 標識）窗口內的特定座標處模擬鼠標點擊，然後遍歷其訪問性樹。
   • 參數：
     • pid (Number, 必填)：目標應用程序的進程 ID (PID)。
     • x (Number, 必填)：點擊的 X 座標（相對於窗口/屏幕，取決於 SDK 行為）。
     • y (Number, 必填)：點擊的 Y 座標。
3. macos-use_type_and_traverse
   • 描述：在目標應用程序（由 PID 標識）中模擬輸入文本，然後遍歷其訪問性樹。
   • 參數：
     • pid (Number, 必填)：目標應用程序的進程 ID (PID)。
     • text (String, 必填)：要輸入的文本。

📄 許可證

文檔未提及相關許可證信息。

📞 聯繫方式

如需幫助，請聯繫 matt@mediar.ai
Discord: m13v_

我們樂意根據你的需求定製此服務器，歡迎通過問題或郵件與我們聯繫。