mcpField
Y
yad-agent-mcp

yad-agent-mcp

本地服务
github.com/holistis浏览器自动化42 周前更新
代码仓库

关于 yad-agent-mcp

yad-agent-mcp 是一个 MCP 服务，让编码 Agent 通过 Yad 的本地 API 操作用户已登录的浏览器。它支持页面导航、内容读取和自然语言浏览器任务，但自身不运行浏览器。

主要功能

  1. 01检查 Yad 和浏览器连接状态
  2. 02在受控浏览器标签页中导航
  3. 03读取页面文本、链接、URL 和标题
  4. 04执行自然语言浏览器任务
  5. 05重新获取最近的任务结果

适用场景

  1. 01读取已登录网页中的信息
  2. 02为 Agent 任务打开指定页面
  3. 03让 Yad 查找页面上的信息
  4. 04检查浏览器任务的结果

MCP 相关

该服务通过 stdio 连接 MCP 客户端与 Yad 的本地 HTTP API，并提供浏览器控制和页面读取工具。它要求本机已安装并运行 Yad，并非远程 MCP 服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "holistis-yad-agent": {
      "command": "npx",
      "args": [
        "-y",
        "yad-agent-mcp"
      ],
      "env": {
        "YAD_COMPANION_URL": "<YAD_COMPANION_URL>"
      }
    }
  }
}
启动命令npx -y yad-agent-mcp
需要配置的环境变量
YAD_COMPANION_URLBase URL of the local Yad companion's HTTP API. Only needed if it runs on a non-default port.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmyad-agent-mcp0.1.1

工具

5

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

yad-agent-mcp

一个 MCP 服务，可让 AI Agent 在用户真实且已登录的浏览器中操控 Yad。Yad 是一款本地优先、注重隐私的浏览器自动化助手。

这是一个轻量封装：它本身不会运行浏览器，而是通过标准输入输出与 Yad 现有的本地 HTTP API（127.0.0.1:3747）通信，因此任何兼容 MCP 的客户端（Claude Code、Cursor、Claude Desktop 等）都可以让 Yad 导航、读取页面或执行自然语言描述的浏览器任务，并获取结果。

仅限本地运行，这是有意为之。 这不是托管式或远程 MCP 服务。它只能在已安装并运行 Yad 的机器上使用（Chrome/Edge/Brave 扩展已安装，且配套应用处于运行状态）。如果你想找一个 Agent 无需任何本地配置，就能通过互联网调用的服务，那这并不是；而且坦白说，任何能够操控用户真实登录浏览器会话的服务都不应该如此。

要求

  • 已安装并运行 Yad（Chrome、Edge 或 Brave 扩展，以及本地配套应用）
  • Node.js 20+

安装

npm install -g yad-agent-mcp

配置 MCP 客户端

Claude Code（.mcp.json 或 claude mcp add）：

{
  "mcpServers": {
    "yad-agent": {
      "command": "yad-agent-mcp"
    }
  }
}

如果 Yad 的配套应用运行在非默认端口，请设置 YAD_COMPANION_URL（默认为 http://127.0.0.1:3747）。

工具

工具功能
yad_status检查 Yad 的配套应用是否正在运行，并已连接到浏览器。请先调用此工具。
yad_navigate在 Yad 控制的浏览器标签页中打开一个 URL。
yad_capture读取当前页面的 URL、标题、可见文本和链接。
yad_run_goal给 Yad 一个自然语言任务（“查找第一个商品的价格”“点击登录按钮”），并等待结果。
yad_last_result重新读取最近一次 yad_run_goal 调用的结果。

无论 Agent 要求 Yad 做什么，未经用户本人确认，Yad 都无法结账、付款或下单。此封装不会添加或移除这一限制，该限制由 Yad 自身强制执行。

源代码

属于 al-yad 单体代码库的一部分。欢迎在那里提交问题和 PR。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。