# @aiosbrain/mcp 中文文档

规范地址：https://npmcn.com/package/%40aiosbrain/mcp/

版本：0\.2\.1
npm 元数据更新时间：2026-09-17T11:43:50.750Z
中文译文更新时间：2026-11-06T20:12:08.795Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40aiosbrain/mcp
原文对照：https://npmcn.com/package/%40aiosbrain/mcp/?lang=original
项目主页：https://github.com/aiosbrain/aios-workspace#readme
源码仓库：https://github.com/aiosbrain/aios-workspace

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

- 包体积（解压后）：96.4 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-09-08T11:47:47.760Z
- 最新版本发布：2026-09-17T11:43:50.440Z
- 近 30 天下载量：2395（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

只读 AIOS Team Brain MCP 服务器,零运行时间依赖性

## 安装

```sh
npm install @aiosbrain/mcp
```

也可以使用：`pnpm add @aiosbrain/mcp`、`yarn add @aiosbrain/mcp`、`bun add @aiosbrain/mcp`

## README

# @aiosbrain/ mcp (英语)

从MCP主机只读取一个AIOS Team Brain. 要求22号节点或更新; 没有 AIOS 检查、 全球工具包安装、 本地模块或运行时间依赖性 .

开始 `npx -y @aiosbrain/mcp@0.2.1`配置 `AIOS_BRAIN_URL` 财务报告和审定财务报表 `AIOS_API_KEY`, (中文(简体) ), 或使用唯一所有者的默认调图 `~/.aios/credentials.json`数字 :

```json
{
  "version": 1,
  "default": {
    "brain_url": "https://brain.example.com",
    "api_key": "<your API key>"
  }
}
```

保持此文件的私密性( E)`chmod 600` 在 POSIX; Windows 上只拥有 ACL ). 东道主 配置应该包含版本被绑定的命令,永远不要包含API密钥. 东道主 安装器在AIO-1112中单独跟踪;不要假设在您的工具包中已有它.

环境证书优先。 现有 `.env` 财务报告和审定财务报表 `aios.yaml` 配置 继续支持。 存储的证书与其大脑源头绑定:更改 URL 单独无法将存储的密钥发送到另一个服务器 。 环境关键需要明确 或已有的工作空间 URL; 它从不从全球证书文件中借用 URL.

启动执行一个 `/api/v1/me` 探测器有三秒钟的最后期限 团队成员得到 所有9个大脑工具; 外部成员得到5个 `brain` 工具。 缺少配置, 证书被吊销、授权令牌、身份反应不当和网络故障 登记不使用大脑工具,并在 Stderr 上进行诊断。 可用性保持不变,直到 重启;Brain检查每通电话的授权,包括会员变更后的授权.

| 工具集 | 工具 |
| --- | --- |
| `brain` | `brain_status`, (中文(简体) ), `brain_search_evidence`, (中文(简体) ), `brain_query`, (中文(简体) ), `brain_pull_items`, (中文(简体) ), `brain_get_item` |
| `board` | `brain_list_projects`, (中文(简体) ), `brain_list_tasks`, (中文(简体) ), `brain_list_decisions`, (中文(简体) ), `brain_stakeholders` |

`--toolsets brain,board` 覆盖 `AIOS_MCP_TOOLSETS`重复 `--tools <name>` 增加工具; 明确选择构成结合,然后与允许的表面相交. `all` 选择 所有允许的工具。 工作空间的收集器只存在于工具包中 `aios mcp`。 。 。 .

运输是新线限制的 stdio,在stdout和 所有诊断在stderr。 初始化返回协议 `2025-11-25` 这个包裹 版本。 查询答案保存引用标记和源列表. 此软件包没有 提供远程 HTTP 端点或写入工具.

维护者: 生成并用 `node packages/mcp-build/pack.mjs --out <new-artifact-directory>` 在源数据库中. 发布已接受的 tarball, 绝不是未创建的源目录 .

### 证据第一答案

`brain_search_evidence` (Brain API 1.27+) 返回对源段落,引用,日期和记录贡献者角色进行排序,而无需调用一个答录模式. 主机构成答案,并可以通过 `brain_get_item`。它属于只读 `brain` 工具盘。 参数 : `query`选项 `project`选项 `limit` (默认8, 最大为20). 答复在20 000个字符以下仍有效;短文予以披露。 旧服务器报告需要升级,而HTTP故障也从未被转换为没有匹配. 不需要额外的密钥或主机MCP服务.

## 6.2.1 国家

明确的整数证据-搜索限制现在通过MCP参数验证. 包装 文物验收试验包括明确的10个限度以及活取.

## 常见问题

### @aiosbrain/mcp 是什么？

只读 AIOS Team Brain MCP 服务器,零运行时间依赖性

### 如何安装 @aiosbrain/mcp？

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

### @aiosbrain/mcp 支持 TypeScript 吗？

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

### @aiosbrain/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aiosbrain/mcp 需要什么版本的 Node\.js？

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

### @aiosbrain/mcp 可以商用吗？

@aiosbrain/mcp 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @aiosbrain/mcp 的下载量有多少？

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

### @aiosbrain/mcp 还在维护吗？

最新版本 0\.2\.1 发布于 2026/09/17（1 个月前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/09/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。