【免费下载链接】Seele希儿最初的家~项目地址https://gitcode.com/gh_mirrors/seele/Seele点击查看免费下载Seele 是一个用「语音识别 TTS AI 大模型 影刀 RPA」实现的桌面宠物项目它的 Botmux 扩展就放在botmux-skill/目录里一个包含seele-rpaSkill 和 MCP 服务器的自包含插件。本文将带你从零开始搭建这个 MCP 服务器并完成安装、配置与调试全流程。一、先搞懂插件的整体架构在动手之前建议先理清 Seele 的三层结构详见 README.md层级职责桌面宠物PyQt5 界面、角色 GIF、气泡、托盘与输入窗口Botmux 连接订阅 Botmux Dashboard 的会话与 SSE 事件展示机器人工作状态RPA 桥接只允许调用已登记的影刀工作流通过带 token 的本地 HTTP 接口供 Botmux MCP 调用Botmux 扩展位于botmux-skill/它提供三样东西seele-rpaSkill、一个暴露白名单工作流工具的 MCP 服务器以及不修改Botmux 的 daemon、worker 或 CLI adapter。二、搭建开发环境Node.js 22 与 Python 3.11插件端和桌面端分别需要两套环境插件端botmux-skillNode.js 22 和 Botmux 3.8用于构建、测试与安装插件。桌面端Seele 本体推荐 Conda Python 3.11conda create -n Seele python3.11 conda activate Seele pip install -r requirements.txt python Seele.py三、配置 Seele 本体让 RPA Bridge 上线MCP 服务器并不会直接操作影刀它通过本地 HTTP 请求 Seele 的 RPA Bridge源码见 rpa_bridge.py。复制botmux_config.example.json为botmux_config.json把bridge.token替换为长随机 token可用python -c import secrets; print(secrets.token_urlsafe(32))生成并开启bridge.enabled注意botmux_config.json已加入.gitignore不要把 token 提交到仓库。四、安装 botmux-skill 插件并启用 seele进入插件目录执行官方流程完整说明见 botmux-skill/README.mdcd botmux-skill npm test botmux plugin install . --link botmux plugin enable seelenpm test会依次执行构建scripts/build.mjs、校验scripts/validate.mjs和冒烟测试scripts/smoke.mjs--link表示以链接方式安装方便开发期热更新启用插件后务必开一个新的 Botmux 会话Skill/MCP 快照才会刷新。五、创建插件私有配置 config.json安装完成后创建~/.botmux/plugins/seele/config.json模板见 config.example.json{ bridgeUrl: http://127.0.0.1:8765, bridgeToken: 与botmux_config.json中相同的token, allowedOpenIds: [ou_你的飞书open_id] }然后收紧权限chmod 600 ~/.botmux/plugins/seele/config.json几个关键细节allowedOpenIds可以是数组或逗号分隔字符串留空时仍要求 Botmux 认证的飞书调用者但接受机器人已允许的任何用户SEELE_BRIDGE_URL、SEELE_BRIDGE_TOKEN、SEELE_ALLOWED_OPEN_IDS三个环境变量可在手动启动 MCP 进程时覆盖文件配置但 Botmux 以受限环境启动插件进程私有配置文件才是可靠的生产路径WSL2 用户注意mirrored 网络下127.0.0.1直接可用NAT 网络下要把bridgeUrl指向 Windows 宿主地址并把 Seele 的 bridge host 设为0.0.0.0同时保留 bearer token、用 Windows 防火墙限制端口。六、MCP 服务器工作原理与调试MCP 服务器入口是 src/mcp/server.js通过 src/mcp/index.json 声明stdio传输方式。它基于 JSON-RPC 2.0 处理initialize、tools/list、tools/call等请求对外暴露 3 个工具工具对应 Bridge 接口说明seele_list_workflowsGET /v1/workflows列出可用的工作流名称与 IDseele_run_workflowPOST /v1/workflows/run提交工作流返回request_idseele_workflow_statusGET /v1/jobs/:request_id查询已提交任务的最新状态用冒烟测试快速验证npm test中的 scripts/smoke.mjs 会临时起一个 mock Bridge 服务然后向真实 MCP 进程发送 JSON-RPC 请求验证initialize返回seele-rpa服务器信息未携带可信调用者身份时seele_run_workflow被拒绝携带botmuxTrustedCaller身份后成功提交Bridge 端恰好收到 1 次运行请求。输出Seele MCP smoke test passed.即表示本地链路健康。调试时的三个高频问题A trusted Botmux/Lark caller identity is required.请求没有_meta.botmuxTrustedCaller身份只有 Botmux 宿主真实调用才会注入该身份手动测试需要自行携带401 unauthorized插件config.json里的bridgeToken与 Seele 的botmux_config.json中的bridge.token不一致accepted不等于完成Bridge 返回accepted只代表已提交需要影刀工作流回调POST /v1/jobs/:request_id/status后才能看到真实的completed或failed。request_id是幂等键同一请求不会重复启动工作流拿不准结果时复用原 ID不要换新 ID 重试。行为约定包括安全红线写在 SKILL.md 中不要用 shell 命令、文件路径或 URL 冒充工作流名工作流运行中也不要操作鼠标键盘。七、小结插件自包含在botmux-skill/npm testbotmux plugin install . --linkbotmux plugin enable seele三步完成安装两份 token 配置Seele 端与插件端必须一致私有配置记得chmod 600调试顺序建议先跑冒烟测试再核对 Bridge 的/healthz最后在新的 Botmux 会话里验证工具调用安全边界Bridge 只接受白名单工作流、非 loopback 监听强制 token、MCP 要求可信飞书调用者身份。完成以上步骤后你就可以在飞书里直接让希儿帮你列出并启动影刀工作流了。祝开发顺利 赞分享【免费下载链接】Seele希儿最初的家~项目地址https://gitcode.com/gh_mirrors/seele/Seele点击查看免费下载相关推荐Penpot MCP 插件开发指南搭建 WebSocket 桥接层并运行本地调试服务器Penpot MCP 插件开发指南搭建 WebSocket 桥接层并运行本地调试服务器 导读 Penpot MCP Plugin 是一个运行在 Penpot前端后端图形学如何构建MCP服务器日志分析Kibana插件完整开发指南如何构建MCP服务器日志分析Kibana插件完整开发指南 想要实现MCP服务器日志的深度分析和可视化吗mcp use项目提供了强大的日志分析能力但结合Ki人工智能后端AI 应用MCP 服务ssh-mcp-server 开发者指南如何快速上手 SSH MCP 服务器的单元测试与本地调试ssh mcp server 开发者指南如何快速上手 SSH MCP 服务器的单元测试与本地调试 ssh mcp server 是一个基于 SSH 的 MCP上一篇openGym贡献者指南如何提交你的第一个Pull Request下一篇如何读懂 Evolver 输出的第一个 GEP Prompt输出结构逐项详解创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考