Skip to content

OrayDev/awesun-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

向日葵 AweSun MCP Server

通过 MCP 协议将向日葵远程控制能力无缝接入 AI 助手,让 AI 能够管理设备、发起远程会话、操作远程桌面。

⚠️ 需要安装最新版本(16.2.3.28762 +)向日葵客户端,并启用相关功能


功能概览

  • 设备管理:添加、搜索、查看、更新设备信息,远程开关机
  • 远控会话:建立远程桌面、CMD、SSH、摄像头、端口转发等会话
  • 桌面操作:在远程桌面中鼠标点击、移动、拖拽、滚轮,键盘输入、组合键、文本粘贴
  • 远程截图:获取远程桌面实时画面,辅助 AI 决策

核心特点

即开即用

  • 内置于向日葵客户端,无需额外安装服务端
  • 一键启用,自动生成 MCP 配置

双模式通信

  • Stdio 模式:本地进程通信,低延迟,适合本地 AI 客户端
  • HTTP 模式:远程通信,支持跨网络调用

完整的远控能力

  • 7个设备管理工具 + 6个远控会话工具 + 9个桌面操作工具
  • 覆盖远程运维、自动化测试、设备管理等场景

安全可靠

  • 基于向日葵成熟的远控安全体系
  • 需设备验证码或已信任设备才能建立连接

使用场景

远程运维自动化 AI 助手可自动登录远程服务器,执行命令、查看日志、重启服务,并截图确认操作结果。

批量设备管理 通过设备搜索和筛选,AI 可批量获取设备状态,识别异常设备并发送告警。

自动化 UI 测试 结合截图和桌面操作工具,AI 可自动操作远程桌面完成 UI 测试流程,验证软件功能。

远程技术支持 AI 可协助用户定位问题,直接操作用户设备查看设置、运行诊断命令,提升支持效率。

快速开始

1. 启用 MCP 服务器

打开向日葵客户端,进入「向日葵MCP」侧边栏菜单,点击「启用MCP服务器」。

2. 选择服务类型

根据使用场景选择通信方式:

  • Stdio(推荐):本地进程通信,适用于本地运行的 AI 客户端(如 OpenCode、Claude Desktop 等)
  • Streamable HTTP:基于 HTTP 的远程通信,适用于需要跨网络调用的场景

3. 配置 AI 客户端

选择完成后,复制生成的配置信息,添加到 AI 客户端的 MCP 配置中即可使用。

工具能力

设备管理

工具名 功能描述
device_add 将新设备添加到设备列表中,可设置设备名称和描述便于管理
device_search 根据关键词模糊搜索设备列表中的设备,支持按设备名称检索
device_info 查询指定设备的完整详细信息,包括硬件配置、网络信息、系统版本等
device_update 修改指定设备的名称和描述信息,用于更新设备列表中的显示名称和备注
device_remove 从设备列表中删除指定的设备,仅移除列表记录不会影响被控端软件
device_wakeup 向绑定了开机硬件的设备发送开机指令,需要设备端配置开机棒或主板支持WOL功能
device_shutdown 向在线的远程设备发送关机指令,设备需处于在线状态且被控端支持关机功能

远控会话

工具名 功能描述
control_connect 发起与指定设备的远控会话连接,支持远程文件、桌面、CMD、SSH、摄像头、端口转发等
control_sessions 查询所有当前活跃的远控会话,包括会话ID/会话类型和状态
control_disconnect 终止指定的活跃远控会话,立即断开与该会话的连接
control_command 在已建立的CMD远程会话中执行命令,目前支持Windows的CMD
control_screenshot 对指定的远程桌面会话进行截图,返回Base64编码的图片数据及尺寸信息
control_portforward 在已建立的端口转发远程会话中配置端口转发规则,用于实现本地与远程主机端口的双向数据转发

桌面操作

工具名 功能描述
desktop_click_mouse 在远程桌面会话中模拟鼠标点击操作,支持左键、右键、中键点击及双击
desktop_move_mouse 将鼠标光标移动到远程桌面的指定坐标位置,常用于拖拽操作前的定位
desktop_drag_mouse 在远程桌面中模拟鼠标拖拽操作,支持按住指定按键沿路径移动
desktop_scroll_mouse 在远程桌面的指定位置模拟鼠标滚轮滚动,支持向上或向下滚动指定次数
desktop_press_keys 在远程桌面中精确控制按键的按下或释放操作,适合需要精细控制按键状态的场景
desktop_typing_keys 在远程桌面中执行组合快捷键操作,如复制、粘贴、保存等
desktop_typing_text 在远程桌面中逐字符模拟键盘输入文本,适合输入短文本内容
desktop_paste_text 在远程桌面中通过系统剪贴板粘贴长文本内容,比逐字符输入更高效
desktop_waiting 在远控操作序列中插入暂停等待,用于等待系统响应或页面加载完成

详细工具文档

推荐的 AI 客户端

  • OpenCode
  • Claude Desktop
  • 其他支持 MCP 协议的 AI 客户端

如需远控桌面操作,需要搭配拥有视觉能力的大模型使用,推荐搭配kimi-k2.5模型

注意事项

  1. 需先安装向日葵客户端(Windows/macOS)
  2. 远程控制功能需要被控设备安装向日葵客户端并保持在线
  3. 部分功能(如开机)需要硬件支持(开机棒或开机插座)
  4. 需要已经验证过设备验证码的设备才能建立远控连接

支持

About

向日葵 MCP(Model Context Protocol) Server

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors