# @ao-mcp/local 中文文档

规范地址：https://npmcn.com/package/%40ao-mcp/local/

版本：0\.3\.13
npm 元数据更新时间：2026-10-26T21:07:13.612Z
中文译文更新时间：2026-11-06T16:30:17.534Z
软件包许可：SEE LICENSE IN LICENSE\.md

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ao-mcp/local
原文对照：https://npmcn.com/package/%40ao-mcp/local/?lang=original
项目主页：https://automatedoperations.com/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：10.6 kB，5 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-07-03T16:32:11.646Z
- 最新版本发布：2026-10-26T21:07:13.354Z
- 近 30 天下载量：2739（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

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

## 安装

```sh
npm install @ao-mcp/local
```

也可以使用：`pnpm add @ao-mcp/local`、`yarn add @ao-mcp/local`、`bun add @ao-mcp/local`

## README

# @ao-mcp/当地

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

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

```bash
# 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 客户端配置的情况下删除本地安装 :

```bash
# 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` 明确表明没有缓存操作数据的结果 已经返回。 将来可能会缓存版本的图案、帮助和运行本资源 释放;活读写从不默默地回落到僵硬的答案.

```bash
# 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:

```json
{"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 仅安装匹配您的一个 机器; 此发射器( name`bin/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](mailto:support@automatedoperations.com) • 妇女 [https://a自发操作.com](https://automatedoperations.com/)

## 常见问题

### @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 和提交记录判断。