关于 agentfenster
agentfenster 是供 Claude Code 等 MCP 客户端使用的本地服务,可在隐藏的第二桌面上自动操作 Windows 应用。它读取 UI Automation 元素并验证每个动作,不占用用户的屏幕、鼠标或键盘。
主要功能
- 01在第二桌面自动操作应用
- 02提供 11 个 GUI 控制工具
- 03读取 UI Automation 元素树
- 04根据窗口状态验证动作
- 05回放近期任务记录
适用场景
- 01自动完成 Windows 应用中的任务
- 02检查并操作指定窗口
- 03查看 GUI 任务步骤失败原因
MCP 相关
通过本地 stdio 向 MCP 客户端提供 11 个工具,用于列出窗口、检查 UI 元素、控制应用和执行 GUI 任务。删除、发送、付款或安装等风险动作默认会被拒绝。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
agentfenster MCP 服务
agentfenster MCP 服务让 Claude Code 和其他 MCP 客户端能够在你自己的会话中,通过隐藏的第二个桌面操作真实的 Windows 应用,同时使用相同的登录状态、Cookie 和 VPN,而你的屏幕、鼠标和键盘仍可照常使用。它是一个本地 stdio 服务,提供 11 个工具,既可一次调用完成任务循环,也可执行单次验证点击。
每次操作完成后,都会根据窗口状态进行验证。点击未命中任何位置时,会报告失败,绝不会悄无声息地当作成功。
完整文档:https://agentfenster.com/mcp
MCP 服务随 agentfenster 应用一起提供。agentfenster 是一款商业闭源 Windows 产品。本仓库是其公开文档和问题跟踪器,不包含产品源代码。
安装
- 从 https://agentfenster.com 在 Windows 10 或 11 上安装 agentfenster。MCP 服务是应用的一部分。每种方案都从 3 天试用期开始,无需银行卡,也无需账户。
- 在 Claude Code 中注册该服务:
claude mcp add agentfenster -- agentfenster-mcp
任何能够启动本地 stdio 服务的 MCP 客户端都可以用同样的方式工作。接下来只需提出请求:
> open the character map on the agent desktop and turn on the advanced view
11 个工具
| 工具 | 功能 |
|---|---|
list_windows | 列出这台机器上可操作的窗口,包括标题、类名、最小化状态,以及是否可以捕获画面。不确定准确窗口标题时,可从这里开始。 |
desktop_task | 在一个窗口中执行完整的 GUI 任务,并以一个段落返回结果:发生了什么、任务是否成功;若失败,则说明失败步骤及原因。点击循环在服务内部运行,因此重试过程不会进入你的上下文。 |
inspect_window | 返回某个窗口经过筛选、限制数量的元素树,以紧凑列表形式呈现,供你自行规划点击。最多包含 200 个元素,且绝不会从桌面根节点开始遍历。 |
replay | 列出最近的运行记录,或返回某次运行的逐步日志:包括每个计划、每项操作、是否产生变化,以及应用中的视觉回放链接。 |
open_app | 在共享的 Agent 桌面上启动程序,并报告其第一个有标题的窗口。Agent 桌面启动时为空,因此需要通过此工具将应用打开到桌面上。 |
read_desktop | 读取 Agent 桌面上某个窗口的紧凑元素树,每个交互元素占一行,不含截图。根据此信息规划点击。 |
click | 根据 read_desktop 提供的 ID 或名称点击一个元素,然后根据桌面状态进行验证,并明确说明是否发生了变化。 |
type_text | 在 Agent 桌面上的一个元素中输入文本,然后验证是否发生了变化。 |
press_key | 按下按键或组合键,例如 ctrl+s、enter、tab 或 alt+f4;也可以先聚焦某个元素,并在操作后进行验证。 |
scroll | 滚动窗口或特定窗格,并报告内容是否实际移动。已经滚动到底部的列表会报告没有效果。 |
agent_windows | 按最前端优先的顺序列出共享 Agent 桌面上当前打开的窗口,方便你通过标题子字符串选择窗口。 |
工作原理
- Agent 在你会话中的第二个 Win32 桌面上工作。它不会占用你的前台窗口、鼠标或键盘,你还可以在应用中实时观看其操作。
- 工具读取 UI Automation 元素树,而不是截图:每个交互元素占一行,每个窗口最多包含 200 个元素。
desktop_task的点击循环在服务内部运行,并使用你配置的模型端点,因此重试和中间步骤都不会进入你的上下文。- 通过 MCP 调用执行删除、发送、付款或安装等有风险的操作时,默认会拒绝并报告,而不会停下来等待无人能响应的确认。
- agentfenster 不会发送遥测数据。唯一的网络流量来自你为点击循环配置的模型端点。
要求
| 平台 | Windows 10 或 11 |
| 传输方式 | stdio,本地 |
| 运行时 | Python 3.11 或更高版本,随应用安装 |
| 前提条件 | agentfenster 应用(商业软件,可试用 3 天) |
链接
- 产品与下载:https://agentfenster.com
- MCP 文档:https://agentfenster.com/mcp
- 定价:https://agentfenster.com/#pricing
- Discord:https://discord.gg/J9MfKP255Y
- 支持:[email protected]
- 隐私:https://agentfenster.com/privacy
- 条款:https://agentfenster.com/terms
问题反馈
如需报告错误或询问 MCP 服务相关问题,请使用此仓库的议题跟踪器,包括工具行为、安装问题和 MCP 客户端兼容性。关于应用本身的问题,通过 Discord 或 [email protected] 联系我们会更快。
权利
agentfenster 是商业闭源软件。此处不授予任何开源许可证。发布此仓库中的文本,是为了让 MCP 用户和目录能够阅读、引用和链接。agentfenster 应用本身的使用受 https://agentfenster.com/terms 中的条款约束。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。