Yad Agent Mcp

io.github.holistis由 GitHub 账号 holistis 发布v0.1.1更新于 Oct 24, 2026

MCP wrapper for Yad, a local browser-automation companion, for coding agents.

已验证STDIO仅桌面浏览器自动化开发者工具

概览

AI 生成的概览

本地 MCP 封装，让编码代理在用户已登录的真实浏览器中驱动注重隐私的浏览器自动化助手 Yad。

可以做什么
  • 检查 Yad 伴生程序是否运行并已连接浏览器
  • 在 Yad 控制的标签页中打开网址
  • 读取当前页面的网址、标题、可见文本和链接
  • 用自然语言给 Yad 下达浏览器任务并等待结果
  • 重新读取最近一次任务的结果
适用场景
适用于希望代理在你已登录的真实 Chrome、Edge 或 Brave 会话中操作——导航、读取页面或执行自然语言浏览器任务——且本机已安装 Yad 的场景。
运行要求
通过 npm 包 yad-agent-mcp 以 stdio 在本地运行，需要 Node.js 20+。必须已安装并运行 Yad：Chrome、Edge 或 Brave 扩展加上本地伴生程序。伴生程序 HTTP API 默认位于 127.0.0.1:3747，若使用其他端口需设置 YAD_COMPANION_URL。未声明认证。
安装前请注意
它会操作你已登录的真实浏览器会话，代理可借助现有会话和 Cookie 行事；任务可能在真实网站上点击和跳转。Yad 自身会阻止未经你确认的结账、付款或下单，本封装既不增加也不移除该限制。仅限本地使用，不是远程服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Yad Agent Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

yad-agent-mcp

An MCP server that lets an AI agent drive Yad, a local, privacy-first browser-automation companion, in the user's real, already-logged-in browser.

This is a thin wrapper: it does not run a browser itself. It talks to Yad's existing local HTTP API on 127.0.0.1:3747 over stdio, so any MCP-compatible client (Claude Code, Cursor, Claude Desktop, etc.) can ask Yad to navigate, read a page, or carry out a plain-language browser task, and get the result back.

Local-only by design. This is not a hosted or remote MCP server. It only works on a machine that already has Yad installed and running (extension in Chrome/Edge/Brave, companion app active). If you're looking for a server your agent can call over the internet with zero local setup, this isn't that, and honestly, nothing that drives a user's real logged-in browser session should be.

Requirements

  • Yad installed and running (Chrome, Edge, or Brave extension plus the local companion app)
  • Node.js 20+

Install

bash
npm install -g yad-agent-mcp

Configure your MCP client

Claude Code (.mcp.json or claude mcp add):

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

If Yad's companion runs on a non-default port, set YAD_COMPANION_URL (defaults to http://127.0.0.1:3747).

Tools

ToolWhat it does
yad_statusChecks whether Yad's companion is running and connected to the browser. Call this first.
yad_navigateOpens a URL in the browser tab Yad controls.
yad_captureReads the URL, title, visible text, and links of the current page.
yad_run_goalGives Yad a plain-language task ("find the price of the first item", "click the login button") and waits for the result.
yad_last_resultRe-reads the result of the most recent yad_run_goal call.

Yad cannot check out, pay, or place an order without the user's own confirmation, regardless of what an agent asks it to do. This wrapper doesn't add or remove that limit, it's enforced by Yad itself.

Source

Part of the al-yad monorepo. Issues and PRs welcome there.

License

MIT

来源：packages/mcp-server/README.md，提交 552a81a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分