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 分