mac_mcp

Name: mac_mcp
Author: TurixAI

作者：TurixAI78 星标更新：2025-11-21

项目介绍

<img src="./doc/LogoHFitted.svg" width="1600" alt="TuriX 标志"> <h1 align="center">TuriX · 由人工智能驱动的桌面操作</h1> 与您的计算机对话，观看它工作。

📞 联系与社区

加入我们的Discord社区以获取支持、讨论和更新：

或通过电子邮件联系我们：contact@turix.ai

TuriX让您的强大AI模型在桌面上执行实际的操作。它配备了一个最先进的计算机使用代理（通过了我们内部OSWorld风格测试集的68%以上），并且完全开源且免费用于个人及研究用途。

偏好自己的模型？在config.json中更改并开始使用。

📰 最新消息

2025年9月30日 - 🎉 兴奋的更新！我们刚刚在TuriX API平台上发布了最新的AI模型，带来了增强的性能、更智能的推理以及更加无缝的集成，使桌面自动化更为强大。开发者和研究人员，现在是时候了——前往平台访问它，并提升您的工作流程！

2025年10月16日 - 🚀 自动化爱好者的大新闻！TuriX现在全面支持前沿的Qwen3-VL视觉语言模型，赋能跨macOS和Windows的PC自动化。这种集成提高了复杂UI交互任务的成功率高达15%（基于我们的内部基准测试），使得您的桌面工作流程比以往任何时候都更加智能和快速。无论是脚本日常例行公事还是处理复杂的项目，Qwen3-VL的高级多模态推理带来了前所未有的精度。

准备好升级了吗？更新您的config.json并开始自动化——祝您编程愉快！🎉

请关注我们的Discord获取技巧、用户故事和下一个重大更新。

🖼️ 演示

<h3 align="center">MacOS 演示</h3> 预订航班、酒店和优步。 <img src="./doc/booking_demo.gif" width="1600" alt="TuriX macOS 演示 - 预订"> 搜索iPhone价格，创建Pages文档，并发送给联系人 <img src="./doc/demo1.gif" width="1600" alt="TuriX macOS 演示 - iPhone价格搜索和文档分享"> 生成老板通过discord发送的numbers文件中的条形图，并将其插入到我的powerpoint的正确位置，然后回复老板。 <img src="./doc/complex_demo_mac.gif" width="1600" alt="TuriX macOS 演示 - excel图表到powerpoint"> <h3 align="center">Windows 演示</h3> 在YouTube上搜索视频内容并点赞 <img src="./doc/win_demo1.gif" width="1600" alt="TuriX Windows 演示 - 视频搜索和分享"> <h3 align="center">MCP与Claude 演示</h3> Claude搜索AI新闻，并通过MCP调用TuriX，将研究结果写入pages文档并发送给联系人 <img src="./doc/mcp_demo1.gif" width="1600" alt="TuriX MCP 演示 - 新闻搜索和分享">

✨ 主要特性

功能	含义
最先进默认模型	在成功率和速度上超越之前的开源代理（如UI-TARS）
无需特定应用程序API	如果人类可以点击，TuriX也可以——WhatsApp、Excel、Outlook、内部工具……
热插拔“大脑”	更换VLM策略而不触碰代码（`config.json`）
MCP就绪	通过模型上下文协议（MCP）连接Claude for Desktop或任何代理

📊 模型性能

我们的代理在桌面自动化任务上实现了最先进的性能：

更多详情，请参阅我们的报告。

🚀 快速入门 (macOS 15)

我们从不收集数据—安装、授权权限，然后开始编程。

0. Windows 用户：切换到windows分支以获取Windows特定的设置和安装说明。
git checkout windows

1. 下载应用

为了方便使用，下载应用

或者按照以下手动设置步骤进行：

2. 创建Python 3.12环境

首先克隆仓库并运行：

conda create -n turix_env python=3.12
conda activate turix_env        # 需要conda ≥ 22.9
pip install -r requirements.txt

3. 授予macOS权限

3.1 辅助功能

打开系统设置 ▸ 隐私与安全 ▸ 辅助功能
点击**＋，然后添加终端和Visual Studio Code** 任何您使用的IDE
如果代理仍然失败，也添加**/usr/bin/python3**

3.2 Safari自动化

Safari ▸ 设置 ▸ 高级 → 启用显示Web开发者的功能
在新的开发菜单中启用
- 允许远程自动化
- 允许JavaScript从Apple事件

触发权限对话框（每个shell运行一次）

# macOS 终端
osascript -e 'tell application "Safari" \
to do JavaScript "alert(\"触发辅助请求\")" in document 1'

# VS Code 集成终端（重复以授权VS Code）
osascript -e 'tell application "Safari" \
to do JavaScript "alert(\"触发辅助请求\")" in document 1'

点击每个对话框上的“允许”，以便代理能够驱动Safari。

4. 配置与运行

4.1 编辑任务配置

[!重要] 任务配置至关重要：任务指令的质量直接影响成功率。清晰、具体的提示会带来更好的自动化结果。

编辑任务在examples/config.json：

{
    "agent": {
         "task": "打开系统设置，切换到暗模式"
    }
}

4.2 编辑API配置

现在从我们的官方网站获取API，有20美元的信用额度。登录我们的网站，密钥位于底部。

编辑API在examples/config.json：

"llm": {
      "provider": "turix",
      "api_key": "YOUR_API_KEY",
      "base_url": "https://llm.turixapi.io/v1"
   }

4.3 配置自定义模型（可选）

如果您想使用未在main.py的build_llm函数中定义的其他模型，您需要先定义它，然后设置配置。

main.py：

if provider == "name_you_want":
        return ChatOpenAI(
            model="gpt-4.1-mini", api_key=api_key, temperature=0.3
        )

根据您的llm切换ChatOpenAI、ChatGoogleGenerativeAI和ChatAnthropic，并更改模型名称。

4.4 启动代理

python examples/main.py

享受免提计算🎉

🤝 贡献

我们欢迎贡献！请阅读我们的贡献指南以开始。

快速链接：

对于错误报告和功能请求，请打开一个问题。

🗺️ 发展路线图

季度	特性	描述
2025 Q3	✅ Windows 支持	跨平台兼容性，将TuriX自动化带到Windows环境 (现已可用)
2025 Q3	✅ 增强的MCP集成	更深层次的模型上下文协议支持，实现无缝第三方代理连接 (现已可用)
2025 Q4	✅ 下一代AI模型	显著提高点击准确性和任务执行能力
2025 Q4	✅ 支持Gemini-3-pro模型	运行任何兼容的视觉语言模型
2025 Q4	计划器	理解用户意图并制定逐步计划来完成任务
2025 Q4	工作流自动化	记录、编辑和重播复杂的多步骤自动化序列
2026 Q1	离线模型选项	完全本地推理，最大限度地保护隐私并消除API依赖
2026 Q1	持久记忆	学习用户偏好并在会话之间维护任务历史
2026 Q2	示范学习	通过展示您的首选方法和工作流程来训练代理
2026 Q2	Windows优化模型	专为微软平台设计的原生Windows模型架构，性能更佳