# @ainecto/mcp 中文文档

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

版本：0\.13\.0
npm 元数据更新时间：2026-11-06T08:56:06.878Z
中文译文更新时间：2026-11-08T08:18:02.799Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40ainecto/mcp
原文对照：https://npmcn.com/package/%40ainecto/mcp/?lang=original
项目主页：https://ainecto.com/en/?utm_source=npm&utm_medium=referral&utm_campaign=agent-directory
源码仓库：https://github.com/codelives/ainecto

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

- 包体积（解压后）：3.5 MB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-07-10T07:34:08.473Z
- 最新版本发布：2026-11-06T08:56:06.550Z
- 近 30 天下载量：1858（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

AiNecto CLI – 每台机器一次将您的编码代理连接到 AiNecto: npx - y ainecto@latest setup. Npx - y anyecto@latest 医生显示任何缺失.

## 安装

```sh
npm install @ainecto/mcp
```

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

## README

# ainecto——AiNecto CLI和MCP连接器

发表于 `ainecto`, (中文(简体) ), `@ainecto/mcp` 财务报告和审定财务报表 `@ainecto/cli` - 同一个代码。 命令 : `ainecto`。 。 。 .

**每台机器一次:** `npx -y ainecto@latest setup` ——通过浏览器(一次)将您签入,检查 连接,并将 Claude 代码、 Cursor 和 Codex 连接到 AiNecto 服务器地址 (单位:千美元)`https://ainecto.com/mcp`) (中文(简体) ). 每一个特工在第一次连接时就自己签到AiNecto.

每个AI会场都可以看到相同的AiNecto工具. 您的 AiNecto 将决定要改变什么工具 在它所触及的工作空间、项目或文档上的权限——服务器拒绝其余的。 还有 没有会话角色(设计/开发/测试/验证在0.8.0中被删除).

## 对于人工智能特工

**运行 `npx -y ainecto@latest setup` (使用长命令超时——至少6分钟:登录等待) 至用户5分钟)。 然后运行 `npx -y ainecto@latest doctor` 并按其说.**

-   `setup` 注册服务器地址,所以每个代理签名 第一次: Claude Code - 运行 `/mcp` 并签名到 `ainecto`; 光标-何时签名 `ainecto` 在其 MCP 中询问 设置; 编码器 - 符号在 `setup` 连接它( 浏览器标签打开, 登录链接为 打印到 stderr; 如果未完成, 运行 `codex mcp login ainecto`) (中文(简体) ).
-   要将 AiNecto 的工作规则添加到仓库中, 运行 `npx -y ainecto@latest init` 从它的根。 这个 不要求角色或项目.
-   **会话期间添加的服务器在该会话中没有可用 .** 继续通过CLI: `npx -y ainecto@latest tools list` 财务报告和审定财务报表 `npx -y ainecto@latest tools call <tool> '<json>'`。一个新的 会话加载 MCP 工具.
-   如果结果指定了一个工具名称,该工具未包含在您的工具列表中,则会话开始于该工具之前 添加 —— 启动新的会话,或如上通过CLI调用.
-   Claude Code 的自动模式可能用 `npx`如果有,请询问用户 允许命令.
-   ChatGPT, Claude等应用程序:参见 [https://ainecto.com/docs/被启动/连接-你的代理/](https://ainecto.com/docs/get-started/connect-your-agent/)

## 设置这个机器

```bash
npx -y ainecto@latest setup              # sign in, check, connect Claude Code · Cursor · Codex
npx -y ainecto@latest setup --dry-run    # show what it would do — no sign-in, no changes
npx -y ainecto@latest setup --local      # connect through the local relay instead (see below)
npx -y ainecto@latest setup --undo       # remove the connections setup made (sign-in stays)
npx -y ainecto@latest status             # who is signed in, your AiNecto role, what is connected
npx -y ainecto@latest doctor             # what is missing, and the one command that fixes each item
```

`setup` 连接每个客户端并报告 `connected`, (中文(简体) ), `updated`, (中文(简体) ), `kept` (别人的) `ainecto` 进入,未触及), `not installed`,或 `failed`如果有任何客户失败,它说“部分”和 1号出入口:

-   克劳德代码.. `claude mcp add --transport http -s user ainecto https://ainecto.com/mcp` (用户范围). 签名 `/mcp` 在一个会议.
-   光标 — 合并 `"ainecto": { "url": "https://ainecto.com/mcp" }` 输入 `~/.cursor/mcp.json`,保留 您的其他服务器 。 Cursor 请您从它的 MCP 设置中签名 .
-   编码 - `codex mcp add ainecto --url https://ainecto.com/mcp`. Codex 立即开始登录 (浏览器标签打开;); `setup` 通过 Codex 的输出, 与登录链接, 通到 stderr. 如果是这样 未在90秒内完成, Codex 显示为 `failed` 但保持连接——运行 `codex mcp login ainecto` (重运行) `setup` 说相同).

与 `--env dev` (或 `--endpoint`地址是环境的。 服务器地址没有版本 针:服务器更新立即到达每个代理。 输入一个年长者 `setup` 写 (单位:千美元)`npx -y @ainecto/mcp@<version>`,有或无 `--role`当您重写到服务器地址时 重新运行 `setup`· ; `setup --undo` 删除任意一种.

`setup --local` 登记本地中继器 `npx -y @ainecto/mcp@<version>` (stodio,钉住) 使用此机的 CLI 版本 `ainecto` 每个特工都签到 只在 代理无法自行签名到服务器地址; 正在运行 `setup` 又没有 `--local` 向后移动 到服务器地址.

您的 AiNecto 角色( 您的工作, 在 AiNecto 的账户设置中设置) 由 `setup` 财务报告和审定财务报表 `status`; 大赦国际使用 对投出的解释来说,它不会改变权限.

## 设置寄存器( 可选)

```bash
npx -y ainecto@latest init               # .ainecto/HARNESS.md, an AGENTS.md block (and CLAUDE.md if present), .ainecto/config.json
npx -y ainecto@latest init --mcp         # also .mcp.json (Claude Code) and .cursor/mcp.json (Cursor), with the server address
npx -y ainecto@latest init --mcp --local # the same files with the local relay instead
npx -y ainecto@latest init --dry-run     # the same plan, nothing written
npx -y ainecto@latest init --undo        # remove what init wrote
npx -y ainecto@latest init --agent tester  # name the agent working in this folder (see below)
```

-   `--agent <name>` 指定在此文件夹中工作的代理。 它把名字写给 `.ainecto/agent.local` (保持它关闭) 并把它放入 `.mcp.json`, (中文(简体) ), `.cursor/mcp.json` 财务报告和审定财务报表 `.codex/config.toml` ——服务器地址条目获得信头 `X-AiNecto-Agent-Name`,本地继电器 获得 `--agent <name>`。重新运行 `init` 保持名称. `ainecto tools call …` 在此文件夹中运行 同一个名字。 服务器检查名称; 拒绝的名称停止 `init` 在文件被写入之前 . `.codex/config.toml` 仅当它尚未存在时才写出(或者它写出) 一个值得信赖的项目.
    
-   `init` 从服务器获取规则—— `--dry-run` 所以计划是真实的 如果不行的话 (没有签名, 离线), 它表示哪个文件会得到这个包的默认文本 .
    
-   如果这台机器还没签字, `init` 打开浏览器一次( e)`--dry-run` 从来没有。 这个 登录的 URL 先被打印( 与 `--json`作为JSON的一条线在 Stderr: `{"event":"login_url","url":…}`) (中文(简体) ).
    
-   它从 git 寄存器的子文件夹中运行时停止,并告诉你根.
    
-   `--mcp` 写入服务器地址, 如 `setup`数字 : `.mcp.json` 获得 `"ainecto": { "type": "http", "url": "https://ainecto.com/mcp" }` (Claude代码需要 `type`和 `.cursor/mcp.json` 获得 `"ainecto": { "url": "https://ainecto.com/mcp" }`。每个代理签名 第一次的时候. `--local` 写入被绑定的本地中继器取而代之(参见 Connectionor Mode).
    
-   **先前设立的仓库** (单位:千美元)`.mcp.json` 与 `npx -y @ainecto/mcp…`,有或无 `--role`: 重新运行 `npx -y ainecto@latest init`它重写现有的 `ainecto` 输入服务器地址 (或与 `--local`,以不包含 `--role`),并放弃了旧的 `project` 从字段 `.ainecto/config.json` (除非你换了) 一个 `ainecto` 条目指向 别的地方就剩一个人了 在那之前,旧条目继续工作: `--role` 已接受,并 被忽略 。 旧旗( 二`--role`, (中文(简体) ), `--project`, (中文(简体) ), `--project-name`, (中文(简体) ), `--yes`) 被一行音符忽略.
    

## 图标

偏爱 `npx -y ainecto@latest <command>`。要安装一次,请使用 `npm install -g ainecto` - 不过.. 只安装 **一个** 联 合 国 `ainecto`, (中文(简体) ), `@ainecto/mcp` 财务报告和审定财务报表 `@ainecto/cli` 全球范围:它们是相同的代码 和所有船只 `ainecto` 命令,所以第二个全局安装冲突。 ()`@ainecto/mcp` 还携带 `mcp`,桥. )

```bash
ainecto auth login          # once per machine (and per --env) — `setup` does this for you
ainecto auth status
ainecto auth logout

ainecto tools list
ainecto tools call list_projects --json
ainecto tools call erd_apply_changes -f changes.json --json
cat payload.json | ainecto tools call erd_apply_changes --json

ainecto projects list
ainecto erd apply-changes -f erd-operations.json --yes
```

工具名称是服务器的自有名称( T)`list_projects`, (中文(简体) ), `erd_apply_changes`(中文(简体) ). 你的人工智能客户端 以自己的前缀显示它们, 例如 `mcp__ainecto__list_projects` claude 代码; CLI 不使用前缀。 开始的工具名称 服务器老了 `mcp__ainecto__` 前缀仍然被接受.

每个命令都用 `--env dev` 页:1 `https://dev.ainecto.com/mcp`。结束点分辨率优先级:

1.  `--endpoint <url>`
2.  `AINECTO_MCP_ENDPOINT`
3.  `--env dev`
4.  生产默认, `https://ainecto.com/mcp`

端点 URL 必须使用 `https:`常规 `http:` 只接受本地主机回回转目标 作为 `127.0.0.1`时 `AINECTO_TOKEN` 设置, CLI 只将其发送到默认的 prod/ dev 端点 除非 `AINECTO_ALLOW_CUSTOM_ENDPOINT_TOKEN=1` 为明确信任的自定义终点设置.

命令是 `ainecto` 财务报告和审定财务报表 `mcp` (哪个) `npx -y @ainecto/mcp` 运行)。 这个 `AINECTO_*` 环境 以上变量为 **仅限** 这些设置的名称 – 不要猜测另一个前缀 .

## 生成友好命令

每个已检查的生成目录工具可以通过它的决定性命令路径到达 。 斯卡尔 schema 字段作为旗帜被曝光,同时接受kebab 和 schema 字段:

```bash
ainecto documents list --project-uuid <projectUuid>
ainecto documents list --projectUuid <projectUuid>
```

阵列或物体有效载荷使用第一当事方的CLI JSON有效载荷读取器:

```bash
ainecto documents create -f create-documents.json
cat erd-operations.json | ainecto erd apply-changes --json
```

破坏生成的命令在人类模式中迅速,除非 `--yes` 提供。 单位 `--json` 模式 除非 `--yes` 已存在.

附件文件的上传可通过一个执行上传脚本、生字的铃声命令提供 PUT 和附件注册流程 :

```bash
ainecto attachments upload --document-uuid <documentUuid> ./diagram.png ./notes.pdf
```

生成的 `request_upload_token` 财务报告和审定财务报表 `upload_attachments` 路径仍为原始 MCP 辩证合同 命令,不读取本地文件.

收件箱投票——为计时器(cron, slowingd),仅在某事出新时才叫醒代理. 退出 代码 : `0` 新项目, `3` 没有什么新鲜事, `1` 错误, `2` 使用错误. `notifications poll` 保存批次 至光标文件后再打印,再打印同一批,直到 `notifications ack` (运行) 只有在代理商处理了这批货之后才这样做. `agent-todos poll --only-new` 仅对待办事宜退出 0 从未见过(见所见文件)。 两个都拿 `--workspace <uuid>` 财务报告和审定财务报表 `--project <uuid>`, (中文(简体) ), 每个重复:任何给定的工作空间和任何给定的项目。 每个过滤器是它的 拥有通知流, 所以每个过滤器使用一个光标文件 .

```bash
ainecto notifications poll --direct-only --cursor-file ~/.ainecto/inbox.cursor --json > /tmp/inbox.json \
  && claude -p "Summarize these AiNecto notifications: $(cat /tmp/inbox.json)" \
  && ainecto notifications ack --cursor-file ~/.ainecto/inbox.cursor
ainecto agent-todos poll --only-new --seen-file ~/.ainecto/todos.seen --json > /tmp/todos.json \
  && claude -p "Review these AiNecto to-dos and only summarize them: $(cat /tmp/todos.json)"
```

背后的服务器工具( Name`list_notifications`, (中文(简体) ), `list_agent_todos`, (中文(简体) ), `update_agent_todos`, (中文(简体) ), `list_history`)也是生成命令(`ainecto notifications list`, (中文(简体) ), `ainecto agent-todos list`, (中文(简体) ), `ainecto agent-todos update -f …`, (中文(简体) ), `ainecto history list`一旦服务器曝光了它们.

## 终端会话

`ainecto term` 关闭终端窗口后继续运行终端会话 — 没有 tmux 或 cmux 需要帮助。 一个背景进程,根据需要开始,拥有每个会话并保持它的屏幕,所以代理和 脚本可以键入会话并读取其屏幕,也可以从任何终端应用中附加. 它继续运行 仅此机器; 它不使用您的 AiNecto 登录 .

```bash
ainecto term new api --cwd ~/code/api -- claude   # start a session (without a command: your login shell)
ainecto term ls [--json]
ainecto term send api "run the tests"             # types the text, without Enter
ainecto term key api enter                        # one key — see below
ainecto term read api [--lines N] [--scrollback] [--json]
ainecto term wait api --match 'passed' [--timeout 600]   # until a screen line matches (seconds)
ainecto term attach api                           # detach with Ctrl-\ then d
ainecto term kill api
ainecto term kill-server                          # every session and the background process
ainecto term restore                              # after a reboot: start again what was running
```

-   密钥 `key`数字 : `enter`, (中文(简体) ), `tab`, (中文(简体) ), `shift-tab`, (中文(简体) ), `escape`, (中文(简体) ), `backspace`, (中文(简体) ), `delete`, (中文(简体) ), `space`, (中文(简体) ), `up`, (中文(简体) ), `down`, (中文(简体) ), `left`, (中文(简体) ), `right`, (中文(简体) ), `home`, (中文(简体) ), `end`, (中文(简体) ), `pageup`, (中文(简体) ), `pagedown`, (中文(简体) ), `ctrl-a` . `ctrl-z` (单位:千美元)`ctrl+c`, (中文(简体) ), `esc` 财务报告和审定财务报表 `return` 也接受.
-   `send --paste` 当应用程序要求时, 将文本作为括号内粘贴发送 。 发送开始的文本 与 `-`,放在后面 `--`。 。 。 .
-   单位 `attach`按钮 `Ctrl-\` 两次发送一个 `Ctrl-\` 对应用程序.
-   在会场里, `AINECTO_TERM_SESSION` 持有它的名字。 名称不变; 要重命名, 杀死 重新开始.
-   `restore` 重新启动正在运行的每个会话( 名称、 文件夹、 命令) , 环境为 贝壳你运行它。 它不会带回 程序在记忆中拥有的, 没有重启它 在重启后拥有的 自行退出的会话被遗忘; `kill` 财务报告和审定财务报表 `kill-server` 忘记他们的.
-   文件在 `~/.ainecto/term/` 控制套接字, `sessions.json` (怎样) `restore` 开始)和 `daemon.log` (每个请求一行,每个答复一行;保留到10 MB+1个更老) 文档, `daemon.log.1`) (中文(简体) ). 输入的文本、屏幕和环境值没有记录.
-   一个命令等待了多久, 三个不同的限制:
    -   运行中的背景进程每次请求最多等待10秒的答案;然后是 命令以错误停止,并删除任何内容.
    -   开始背景进程每次尝试最多等待10秒,最多3次尝试即可报告.
    -   `wait` 自己等待着 `--timeout` (没有它,直到模式出现或会话结束).
-   平台:macOS,和有glibc在20.js 20.8.0或更新(其余CLI运行于Node 18)上的Linux. 还没有Windows。 它使用可选依赖 `node-pty`,用于预建的二进制 — 没有编译器 需要帮助。 如果无法安装, `ainecto term` 说到这里,其他命令继续运作.

## 连接模式

```bash
ainecto mcp [--env dev]
```

包作为解决的 stdio- to- HTTP 代理 `/mcp` 终点 它代表着 `initialize`, (中文(简体) ), `tools/list`,以及 `tools/call`,不重写远程计划,也不解释 本地文件引用 。 它使用这台机器的 单个登录(`ainecto setup`, (中文(简体) ), `ainecto auth login`,或 登录 `ainecto init` ),从不单独打开浏览器.

这是条目 `setup --local` 财务报告和审定财务报表 `init --mcp --local` 写 —— 一般不用手加入 (无) `--local` 他们写服务器地址,如上:

```json
{
  "mcpServers": {
    "ainecto": {
      "command": "npx",
      "args": ["-y", "@ainecto/mcp@0.13.0"]
    }
  }
}
```

旧条目 `--role <name>` (或 `AINECTO_ROLE`)仍然开始:数值被忽略,单行 注释到 stderr,服务器只记录旧设置仍在使用中。 如果有会议 不见 AiNecto 工具, 另一个 `ainecto` 条目(例如Claude Code的地方范围)可能是 藏起来 `ainecto doctor` 检查这个.

### MCP 书记官处

`server.json` 是书记官处条目 `com.ainecto/mcp` (与 `package.json#mcpName`) (中文(简体) ). 这个 列出服务器地址 `https://ainecto.com/mcp` (远程可流式HTTP——什么) `setup` 登记册)和 npm 软件包 `@ainecto/mcp` (桥梁) `setup --local` 财务报告和审定财务报表 `init --mcp --local` ),写作. 书记官处 发布时需要npm版本 它的引用 `mcpName`所以先发布npm. 登记由下列人员进行:

1.  `npm run release -- --otp=<code>` (以下)这样 `@ainecto/mcp@<version>` 这是npm.
2.  域名登录 `ainecto.com` (HTTP: ) (韩语) `https://ainecto.com/.well-known/mcp-registry-auth` 必须 服务公钥; 私钥位于macOS密钥链: `mcp-publisher login http --domain ainecto.com --private-key "$(security find-generic-password -s codelive-mcp-registry -a ainecto.com -w)"`。 。 。 .
3.  `mcp-publisher publish` 从此文件夹中.

最多为0.8.1 `io.github.codelives/ainecto` (只有包装);在 首个 `com.ainecto/mcp` 发布。 详细情况 `docs/mcp-registry-registration.md`。 。 。 .

## 发展

```bash
npm install
npm run typecheck
npm test
npm run build
npm link            # puts `ainecto` on your PATH
```

### 目录同步

`sync:tools --check` 用于发布时间的活体漂流检查。 当它迅速失效时 `AINECTO_CATALOG_SYNC_TOKEN` 缺少,所以自动发布不能无声地回到固定状态. 为了地方发展, `sync:tools` 也可以使用来自 `ainecto auth login --env <env>`。 。 。 .

```bash
AINECTO_CATALOG_SYNC_TOKEN=... npm run sync:tools -- --env prod --check
AINECTO_CATALOG_SYNC_TOKEN=... npm run sync:tools -- --env dev --check
```

已检查生成的目录是确定性产出 `tools/list`从,活的 - synced from `https://ainecto.com/mcp` 财务报告和审定财务报表 `https://dev.ainecto.com/mcp`。演示文稿元数据分别存在于 `src/core/catalog/enrichments.ts`。 。 。 . `ainecto tools catalog` 打印本地生成的目录.

### 当地打球烟

```bash
npm pack
npm exec --package ./ainecto-mcp-<version>.tgz -- ainecto --help
```

### 现场直播Dev MCP 烟

这需要从 `ainecto auth login --env dev` 或本地开发者 `AINECTO_TOKEN`。 。 。 .

```bash
npm run smoke:mcp -- --env dev
```

烟雾将MCP初始化 `tools/list`,电话 `list_projects`,仅打印汇总 元数据,如工具计数和任务工具曝光.

### 本地附件上传烟雾

这充分锻炼 `attachments upload` 相对于本地 API dev 服务器的流: OAuth MCP 令牌 , REST 固定文档创建, CLI 上传, `list_attachments`,和服务器文件系统字节 核查.

```bash
npm run smoke:attachments -- --base-url http://localhost:8080 --endpoint http://localhost:8080/mcp --api-root <path-to-api-repo>
```

烟雾造成一个临时用户/工作空间/项目/文件,并去除固定账户,当地 临时文件,并存储上传文件,除非 `--keep` 提供.

### 释放

`npm run release -- --otp=<code>` 运行类型检查、测试和构建一次,然后发布在 三个名字: `@ainecto/mcp` (小学), `ainecto`,以及 `@ainecto/cli` (仅限 `ainecto` 页:1. `--dry-run` 显示什么会出去。 已发布的名称被跳过, 因此在过期后重试 代码是安全的。 npm 账户需要写入访问权限 `@ainecto` org(脚本检查)。 别 解开任何名字.

## 已知的限制

-   MCP连接器执行新线限制的stio JSON-RPC到HTTP JSON-RPC. 可流式 HTTP SSE 答复和答复 `MCP-Session-Id` 未执行会话处理 .

## 常见问题

### @ainecto/mcp 是什么？

AiNecto CLI – 每台机器一次将您的编码代理连接到 AiNecto: npx - y ainecto@latest setup\. Npx - y anyecto@latest 医生显示任何缺失\.

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

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

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

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

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

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

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

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

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

@ainecto/mcp 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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