Seethelightdie/yingdao-RPA-mcp

影刀(ShadowBot)社区版的 MCP 服务器——微信里用 AI 操控 RPA 机器人 | MCP server for Yingdao/ShadowBot Community Edition

About yingdao-RPA-mcp

把影刀（ShadowBot）社区版机器人变成 AI 助手里的"原生工具"—— 微信里说一句话，就能列出、启动、停止你电脑上的 RPA 流程。

English TL;DR: An MCP (Model Context Protocol) server that exposes Yingdao/ShadowBot Community Edition RPA robots to any AI client. Local stdio + remote streamable-http (Tailscale-friendly) with token auth, a built-in Mock mode, graceful-stop-only design (never kill processes), and 94 cross-platform tests. MIT licensed, unofficial, community-driven.

影刀社区版没有官方 API，机器人只能靠人点界面启动。已有的民间方案（见致谢）解决了 "远程一键启动"，但接到 AI 助手上还有四道坎：协议不对口（AI 助手说 MCP）、跑完没下文（拿不到结构化结果）、 停止不可靠（杀进程会烂尾）、远程不安全（裸端口）。

本项目把影刀社区版的四条"民间侦察通道"封装成 5 个标准 MCP 工具，在 52 台真实机器人的环境里、 通过微信 AI 助手完成了端到端验收。

- 🔧 5 个 MCP 工具：listrobots 列出 / runrobot 启动（支持中文传参、产出文件回收）/ getstatus 三层日志验证 / stoprobot 优雅停止 / taillog 排障 - 🔌 双传输：本地 stdio（Claude Desktop 即插即用）+ 远程 streamable-http（Tailscale 组网跨网操控） - 🔐 安全边界：静态 Bearer token、绑定地址可控、stateless-http（网关重启对客户端透明）、 Windows 防火墙仅放行 Tailscale 网段 - 🧪 Mock 模式：没有 Windows / 没装影刀也能体验全部工具，同时是 94 个自动化测试的替身 - 🛑 只优雅停止，永不杀进程：keybdevent 发送 Ctrl+Alt+Q（工具描述内置全局停止警告， AI 会先向你确认） - 🇨🇳 中文友好：机器人名/传参值支持中文原样，错误信息统一"code + 中文说明 + 下一步提示" - 📦 Windows 一键安装：一条命令完成 Python 探测、虚拟环境、token、防火墙、开机自启、自检

工具 作用 ------ listrobots 扫描影刀用户目录，返回 uuid/名称/版本/描述/路径（按修改时间排序） runrobot 启动机器人，支持 key=value 传参（值支持中文）；可指定产出目录，返回运行期间新增的文件 getstatus 解析影刀当日日志 + 进程存活检测，返回 运行中/已退出/未知 与证据链 stoprobot 发送 Ctrl+Alt+Q 优雅停止（⚠️ 全局生效——会停掉所有运行中的机器人，工具描述已强制警告） taillog 读取影刀当日日志尾部，排障用

- 影刀社区版已安装（官网） - Python 3.10+（仅本地 stdio / 手动运行需要；一键安装脚本会自动引导） - 一个支持 MCP 的 AI 客户端（Claude Desktop、微信 AI 助手等）

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/Seethelightdie--yingdao-RPA-mcp.html)

Related MCP servers