MCP Mac应用服务器
MCP服务器,用于通过LLM管理macOS应用程序。允许启动应用程序,通过AppleScript管理它们,并获取有关运行应用程序的信息。
🎤 语音控制:使用 voice_client.py 通过语音控制应用程序!看 VOICE_SETUP.md
特性
- 🚀 启动应用程序 -在Mac上打开任何应用程序
- 📋 列出正在运行的应用程序 -获取活动应用程序列表
- 🤖 AppleScript自动化 -在应用程序中执行命令
- ❌ 关闭应用程序 -退出应用程序
- 📂 打开文件 -在特定应用程序中打开文件
安装
Python版本(推荐)
- 确保你安装了Python 3.7+
- 安装依赖项:
pip install -r requirements.txt- 服务器已准备好使用!无需编译。
TypeScript版本(备选)
- 确保你安装了Node.js(v18+)和npm
- 安装依赖项:
npm install- 构建项目:
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 Safari2.获取应用程序列表
What applications are currently running?3.执行AppleScript
In Safari, open a new tab4.关闭应用程序
Close Calculator5.打开文件
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访问
许可证
麻省理工学院
