@ao-mcp/local

中文文档
0.3.13发布于 2026/10/27SEE LICENSE IN LICENSE.md零依赖近 30 天下载 2739

自动操作的本地MCP桥——将任何MCP客户端用浏览器签名指向您的AO工作空间.

中文使用文档
文档目录7 节
  1. 离线行为
  2. 在您的 MCP 客户端启动后签名
  3. 重大成果( ao://results/… (中文(简体) )
  4. 文件资源 ao://docs/… (中文(简体) )
  5. 图标
  6. 如何包装
  7. 支助

@ao-mcp/当地

机器MCP桥 自动化业务它作为本地运行 stdio MCP 服务器和代理到主机AO MCP端点,处理浏览器 您的注册和会话/自动.

桥为土生土长的Go 二进制. npm 是一个分发选项, 不是 a 运行时间依赖。 没有节点或npm安装它:

# macOS / Linux
curl -fsSL https://mcp.automatedoperations.com/install.sh | sh

# Windows PowerShell
irm https://mcp.automatedoperations.com/install.ps1 | iex

两个安装者都从公共登记处解决了签名的平台软件包, 验证其SHA-512完整性,并安装 ao-mcp-local 输入用户拥有的 bin 目录。 设定 AO_MCP_INSTALL_DIR 在安装时选择不同的 地点。 原生设施然后检查、核实和激活AO释放 自动;下一个自然的MCP进程开始使用新的二进制. 有一个 没有消费者更新设置或维护命令.

在不更改 MCP 客户端配置的情况下删除本地安装 :

# macOS / Linux
curl -fsSL https://mcp.automatedoperations.com/install.sh | sh -s -- --uninstall

# Windows PowerShell
& ([scriptblock]::Create((irm https://mcp.automatedoperations.com/install.ps1))) -Uninstall

使用 npx -y @ao-mcp/setup remove 当 AO 条目也应该是时 从检测到的 MCP 客户端中移除。 取消对二进制的设置永不删除登录 配置文件或来自用户选择的安装目录的无关文件.

拥有所有权的组织可通过其自主作业安排管理本土部署 组织政策。 代理只接受有效的认证政策 aO Cloud 返回; 本地用户和机器管理员无法创建 针. AO不向消费者安装显示版本选择.

离线行为

本地代理不缓存基础设施状态 。 当AO云或 网络没有可用, 操作工具呼叫返回可重试 ao_unavailable 明确表明没有缓存操作数据的结果 已经返回。 将来可能会缓存版本的图案、帮助和运行本资源 释放;活读写从不默默地回落到僵硬的答案.

# one-time sign-in (opens your browser)
npx @ao-mcp/local login

# most users never run it directly — `npx @ao-mcp/setup` wires it into your
# MCP client (Claude Desktop, Cursor, VS Code, …), which spawns it for you

在您的 MCP 客户端启动后签名

桥即使没有可用标志也开始通车. 然后它只列出自己的 工具 (单位:千美元)authenticate, (中文(简体) ), auth_status, (中文(简体) ), switch_account, (中文(简体) ), sign_out, (中文(简体) ), local_agent_status)并用一个 auth_required 结果。 以两种方式签名 :

  • 请代理商打电话 authenticate (打开浏览器),或
  • 运行 npx @ao-mcp/local login 在航站楼里 奔跑的桥会注意到 几秒钟内就签到.

无论哪种方式,相同的 MCP 会话连接: 桥会发送 notifications/tools/list_changed 下一个 tools/list 包括 远程工具。 不需要客户端重新启动 .

重大成果(ao://results/…(中文(简体) )

工具结果太大, 无法返回内行 resource_link 改为: ao://results/<id> URI(也出现在结果中) _meta["ao.resultResource"]时 _meta["ao.resultExpiresAt"]) (中文(简体) ). 读取 完成 JSON 与 resources/read 关于URI:

{"jsonrpc":"2.0","id":7,"method":"resources/read","params":{"uri":"ao://results/<id>"}}

链接属于制作它的MCP会话:从同名读取 15分钟内开庭 注册后, 账户切换或重新连接 重新运行工具.

文件资源ao://docs/…(中文(简体) )

AO 文档可以从会话内部读取, 版本为 AO 云释放连接到: resources/read 打开 ao://docs/<path> 返回一页为下标(模板) ao://docs/{path} 内 resources/templates/list) (中文(简体) ). 查找带有 docs_search 工具; 那些工具 不在默认工具列表中 find_tools 运行 call_tool。 。 。 .

图标

ao-mcp-local             run the stdio MCP bridge (default; MCP clients spawn this)
ao-mcp-local login       sign in via your browser and store a session token
ao-mcp-local logout      clear the stored token
ao-mcp-local version     print version

您的会话令牌存储在 OS 密钥链( MacOS keychain, Windows) (原始内容存档于2017-09-26). Creditial Manager, Linux Secret Service). 可用时,另作a 权限限制文件。 设定 AO_TOKEN 直接提供符号 (无头/CI,不刷新或账户切换). 模拟试验跑道 可以设置 AO_TOKEN_FILE 改为绝对值 token.json 路径;其兄弟关系 profiles.json 保留正常的可刷新多账户行为.

如何包装

二进制船作为平台的可选依赖 (单位:千美元)@ao-mcp/local-<platform>-<arch>npm 仅安装匹配您的一个 机器; 此发射器( namebin/cli.js解决它,执行它,通过你的 MCP客户端的stdio直通. 没有邮寄下载, 没有外部下载 主机——npm携带字节. macOS 二进制是开发者ID签名和 已公证; Windows 二进制已签名 .

平台软件包
macOS arm64 / x64 (英语)@ao-mcp/local-darwin-arm64 • 妇女 @ao-mcp/local-darwin-x64
Linux arm64 / x64 (英语)@ao-mcp/local-linux-arm64 • 妇女 @ao-mcp/local-linux-x64
视窗arm64 / x64@ao-mcp/local-win32-arm64 • 妇女 @ao-mcp/local-win32-x64

支助

问题,问题,反馈——我们想听听你们: 支持@ a自动操作.com • 妇女 https://a自发操作.com

版本与发布记录

@ao-mcp/local 共发布 22 个版本,首次发布于 2026/07/04;过去 12 个月发布了 22 个版本。

版本发布日期距今
0.3.13latest2026/10/2711 天前
0.3.122026/10/2712 天前
0.3.112026/10/2612 天前
0.3.102026/10/2612 天前
0.3.92026/10/2612 天前
0.3.82026/10/2414 天前

关于 @ao-mcp/local 的常见问题

@ao-mcp/local 是什么?

自动操作的本地MCP桥——将任何MCP客户端用浏览器签名指向您的AO工作空间.

如何安装 @ao-mcp/local?

在项目目录运行 npm install @ao-mcp/local,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ao-mcp-local,可以用 npx ao-mcp-local 直接运行。

@ao-mcp/local 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ao-mcp__local 是否存在。

@ao-mcp/local 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ao-mcp/local 可以商用吗?

@ao-mcp/local 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@ao-mcp/local 的下载量有多少?

根据 npm 官方下载统计,@ao-mcp/local 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,739 次,日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ao-mcp/local 还在维护吗?

最新版本 0.3.13 发布于 2026/10/27(11 天前);至今共发布 22 个版本,其中过去 12 个月发布了 22 个;首次发布于 2026/07/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。