AI导哈

Mac应用管理服务器

通过LLM管理macOS应用程序的服务器，支持启动应用、通过AppleScript管理和获取运行中应用信息。

  • by TrueOleg
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 TrueOleg/MCP-expirements

使用说明

MCP Mac应用服务器

MCP服务器，用于通过LLM管理macOS应用程序。允许启动应用程序，通过AppleScript管理它们，并获取有关运行应用程序的信息。

🎤 语音控制：使用 voice_client.py 通过语音控制应用程序！看 VOICE_SETUP.md

特性

  • 🚀 启动应用程序 -在Mac上打开任何应用程序
  • 📋 列出正在运行的应用程序 -获取活动应用程序列表
  • 🤖 AppleScript自动化 -在应用程序中执行命令
  • ❌ 关闭应用程序 -退出应用程序
  • 📂 打开文件 -在特定应用程序中打开文件

安装

Python版本（推荐）

  1. 确保你安装了Python 3.7+

  2. 安装依赖项：

pip install -r requirements.txt
  1. 服务器已准备好使用！无需编译。

TypeScript版本（备选）

  1. 确保你安装了Node.js（v18+）和npm

  2. 安装依赖项：

npm install
  1. 构建项目：
npm run build

用于MCP客户端的配置

克劳德桌面版

将配置添加到MCP客户端设置文件中。对于Claude Desktop，这通常是MCP配置文件：

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mac-apps": {
      "command": "python3",
      "args": ["/Users/olegzaichkin/Documents/MCP/src/server.py"]
    }
  }
}

或者使用tsx进行开发：

{
  "mcpServers": {
    "mac-apps": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/Users/olegzaichkin/Documents/MCP"
    }
  }
}

其他法学硕士和客户

可用选项:

  • 克劳德桌面版 （推荐）-完全支持MCP
  • 奥拉玛 ✅ - 本地模型（已安装，已加载模型）-请参阅 OLLAMA_SETUP.md
  • LM 工作室 -本地LLM的图形界面
  • 深度求索 -看 DEEPSEEK_SETUP.md

📖 兼容LLM和说明的详细列表: 兼容LLM.md

用法

配置后，LLM将能够使用以下工具：

1.打开应用程序

Open Safari

2.获取应用程序列表

What applications are currently running?

3.执行AppleScript

In Safari, open a new tab

4.关闭应用程序

Close Calculator

5.打开文件

Open file ~/Documents/example.txt in TextEdit

可用工具

open_application

按名称打开应用程序。

参数：

  • appName （string）-应用程序名称（例如“Safari”、“Calculator”）

get_running_applications

返回所有正在运行的应用程序的列表。

run_applescript

在指定的应用程序中执行AppleScript命令。

参数：

  • appName （string）-应用程序名称
  • script （string）-AppleScript命令

AppleScript示例：

  • 游猎： make new document -创建新选项卡
  • 查找器： open folder "Documents" -打开文件夹
  • 文本编辑： make new document -创建新文档

quit_application

关闭指定的应用程序。

参数：

  • appName （string）-要关闭的应用程序名称

open_file_with_app

在指定的应用程序中打开文件或URL。

参数：

  • path （string）-文件或URL的路径
  • appName （string）-应用程序名称

测试

要测试服务器，请执行以下操作：

node test-mcp-server.js

或手动测试：

npm run build
npm start

发展

对于自动重新加载的开发：

npm run dev

安全

⚠️ 警告： 此服务器允许在您的系统上执行命令。仅在受信任的LLM客户端和安全环境中使用它。

对于macOS，您可能需要权限来控制其他应用程序：

  • 系统设置→ 隐私和安全→ 自动化
  • 允许终端/Node.js访问

许可证

麻省理工学院

相关 MCP