Deepin MCP Servers
xsluck/deepin-mcp-servers
Suite completa de ferramentas MCP para automação e controle do Deepin
Ver no GitHubServidor MCP completo para o sistema Deepin que integra gerenciamento de aplicações, operações de arquivos, controle de sistema, automação de navegador, busca web e integração com DBus. Oferece 40+ ferramentas incluindo git, terminal, email e controle de desktop.
Instalação
npx convez-ai xsluck/deepin-mcp-servers1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de tarefas do sistema Deepin via MCP
- Controle programático de navegador e busca web
- Operações de arquivo e git integradas
- Integração com serviços DBus do Deepin
- Execução de comandos terminal segura
Veredito

Implementação robusta e bem estruturada de MCP server específica para o Deepin, com cobertura impressionante de funcionalidades (40+ apps, git, browser, DBus). Excelente para quem precisa automatizar o desktop Deepin, mas o escopo abrangente e dependências de sistema exigem experiência técnica significativa.
README
A tradução para o português deste README ainda está na fila.
Deepin MCP Servers
简介
一个为 Deepin 系统设计的 MCP (Model Context Protocol) 服务器实现,提供系统工具、文件操作、网络搜索等功能。 源自 Deepin 的 MCP 服务器实现,并进行了优化和扩展。
功能特性
🚀 应用管理
- 启动应用: 支持启动系统内置应用
- 支持的应用包括:日历、文件管理器、计算器、相机、画图、文本编辑器、音乐、影院、浏览器、控制中心等40+个应用
📁 文件操作
-
基础文件操作
- 打开文件(使用系统默认程序)
- 复制文件/文件夹
- 移动文件/文件夹
- 重命名文件/文件夹
- 删除文件/文件夹
- 创建新文件
- 创建新文件夹
- 批量重命名文件
- 列出目录内容(支持递归)
- 获取文件大小信息
- 获取用户目录路径
-
文档处理
- 支持读取多种文档格式:
- 文本文件 (.txt, .md)
- Microsoft Office 文档 (.doc, .docx, .xls, .xlsx, .ppt, .pptx)
- PDF 文档
- 其他常见格式
- 支持读取多种文档格式:
🌐 网络服务
-
多搜索引擎支持
- 百度搜索
- 必应搜索 (Bing)
- DuckDuckGo 搜索
- Google 搜索
- 搜狗搜索
-
网页内容获取
- 获取网页内容并转换为 Markdown 格式
- 支持内容提取和清理
- 文件下载功能(支持 HTTP/HTTPS)
🖥️ 系统控制
-
桌面环境控制
- 切换系统壁纸(支持指定文件或自动切换)
- 切换任务栏模式(时尚模式/高效模式)
- 开启/关闭勿扰模式
- 切换系统主题(浅色/深色/自动)
-
系统信息
- 获取系统硬件信息(CPU、内存、硬盘)
-
通信功能
- 发送邮件(支持主题、正文、收件人、抄送、密送)
- 创建日程安排(支持标题、开始时间、结束时间)
💻 终端命令
- 安全的命令执行
- 执行常用 Linux 命令
- 危险命令拦截和确认机制
- 支持自定义工作目录
- 命令超时控制(最大120秒)
- 执行结果包含标准输出、错误输出和退出代码
🔧 Git 操作
-
仓库管理
- 查看 Git 仓库状态
- 获取提交历史记录
- 查看分支信息
- 克隆远程仓库
-
文件操作
- 添加文件到暂存区
- 提交更改
- 拉取远程更新
- 推送本地提交
-
差异和历史
- 查看文件修改差异(工作区/暂存区)
- 查看特定提交的详细信息
- 查看文件的修改历史记录
🌐 浏览器控制
-
浏览器自动化
- 支持 Chrome 和 Firefox 浏览器
- 启动/关闭浏览器会话
- 有头模式和无头模式支持
- 页面导航和截图功能
-
页面元素操作
- 多种元素选择器支持(CSS、XPath、ID等)
- 点击页面元素(按钮、链接等)
- 输入框文本输入
- 获取元素文本和属性
- 等待元素出现(智能等待)
-
高级功能
- 执行自定义 JavaScript 脚本
- 页面滚动和元素定位
- 表单自动填写
- 页面信息获取(标题、URL等)
🔔 系统交互
-
DBus 服务集成
- 与 Deepin 系统服务深度集成
- 支持 V20 和 V25 版本的 DBus 接口
- 系统属性读取和设置
-
用户交互
- 显示确认对话框
- 发送系统桌面通知
- 支持自定义图标和超时时间
安装
使用 uv 安装依赖:
uv sync
或使用 pip:
pip install -e .
使用方法
启动 MCP 服务器
python src/deepin_mcp_server/server.py
浏览器控制功能设置
💡 重要提示: 如果您已经安装了Chrome浏览器,可以直接使用!系统会自动下载匹配的ChromeDriver,无需手动安装。
Chrome用户(推荐):
# 如果已安装Chrome,直接测试即可
python test_chrome_direct.py
完整自动设置:
# 运行自动设置脚本
./setup_browser.sh
手动设置:
浏览器控制功能需要安装对应的 WebDriver:
Chrome WebDriver 安装:
# 方法1: 使用包管理器 (推荐)
sudo apt install chromium-chromedriver
# 方法2: 手动下载
# 访问 https://chromedriver.chromium.org/ 下载对应版本
Firefox WebDriver 安装:
# 方法1: 使用包管理器
sudo apt install firefox-geckodriver
# 方法2: 手动下载
# 访问 https://github.com/mozilla/geckodriver/releases 下载
浏览器功能测试
验证浏览器控制功能:
# 启动MCP服务器
python src/deepin_mcp_server/server.py
该示例包含:
- 百度搜索自动化
- GitHub 页面导航演示
- JavaScript 脚本执行
- 表单自动填写演示
项目结构
src/deepin_mcp_server/
├── server.py # 主服务器文件,定义所有 MCP 工具
├── dbus_service/ # DBus 服务模块
│ └── services.py # DBus 接口和服务定义
├── system_tools/ # 系统工具模块
│ ├── file_operation.py # 文件操作功能
│ ├── git_operations.py # Git 操作功能
│ ├── system_control.py # 系统控制功能
│ ├── terminal_command.py # 终端命令执行
│ └── browser_control.py # 浏览器控制功能
└── web_service/ # 网络服务模块
├── services.py # 网络服务主接口
├── utils.py # 工具函数
└── web_search/ # 网络搜索子模块
├── base.py # 搜索基类
├── search.py # 搜索主逻辑
├── search_types.py # 搜索类型定义
├── util.py # 搜索工具函数
└── engines/ # 搜索引擎实现
├── baidu.py # 百度搜索
├── bing.py # 必应搜索
├── duckduckgo.py # DuckDuckGo 搜索
├── google.py # Google 搜索
└── sogou.py # 搜狗搜索
技术依赖
-
Python >= 3.12
-
核心依赖:
httpx >= 0.28.1- HTTP 客户端mcp[cli] >= 1.6.0- MCP 协议支持requests >= 2.30.0- HTTP 请求库
-
文档处理:
PyPDF2- PDF 文档处理python-docx- Word 文档处理python-pptx- PowerPoint 文档处理pandas- 数据处理
-
网页处理:
beautifulsoup4 >= 4.12.0- HTML 解析lxml >= 4.9.0- XML/HTML 处理器markdownify >= 0.11.0- HTML 转 Markdownreadabilipy >= 0.2.0- 网页内容提取readability-lxml >= 0.8.1- 可读性分析lxml_html_clean- HTML 清理
-
浏览器自动化:
selenium >= 4.15.0- 浏览器自动化框架
特色功能
- 深度系统集成: 与 Deepin 桌面环境深度集成,支持壁纸切换、主题切换等系统级操作
- 安全命令执行: 内置危险命令检测和用户确认机制,保障系统安全
- 多搜索引擎: 支持5种主流搜索引擎,自动切换确保搜索成功率
- 完整的 Git 工作流: 从基础操作到高级功能,支持完整的 Git 开发工作流
- 丰富的文档支持: 支持多种文档格式的读取和处理
- 浏览器自动化: 基于 Selenium 的强大浏览器控制,支持复杂的网页任务自动化
- 用户友好交互: 提供对话框确认和系统通知,提升用户体验
日志记录
服务器运行日志保存在:~/.local/share/deepin-mcp-server/deepin-mcp-server.log
兼容性
- 支持 Deepin V20 和 V25 系统
- 自动检测系统版本并使用对应的 DBus 接口
- 向后兼容旧版本系统功能