# @doist/automations-mcp 中文文档

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

版本：2\.2\.0
npm 元数据更新时间：2026-11-11T15:09:41.360Z
中文译文更新时间：2026-11-12T14:54:48.617Z
软件包许可：UNLICENSED

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

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

弃用说明：Moved to @todoist/automations-mcp\. Replace @doist/automations-mcp with @todoist/automations-mcp in your dependencies and imports\.

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

- 包体积（解压后）：2.3 MB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.15\.0 \<25
- 运行依赖：3 个
- peer 依赖：@modelcontextprotocol/server ^2\.2\.0
- 首次发布：2026-09-18T14:03:39.532Z
- 最新版本发布：2026-11-10T17:54:25.029Z
- 近 30 天下载量：13759（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：80（近 12 个月 80 个）

## 中文简介

用于 Todoist 自动化的 MCP 服务器和可导入的 AI 工具

## 安装

```sh
npm install @doist/automations-mcp
```

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

## README

# `@doist/automations-mcp`

Todoist Automations 的 MCP 服务器: 给一个代理以相同权限的工具 自动化 `tda` CLI 给定,为主机 MCP 服务器打包 `ai.todoist.net`编辑 设计,它的一部分推出在 [光谱](https://npmcn.com/package/docs/specifications/automations-mcp-package.md)。 。 。 .

## 出口的东西

`getMcpServer({ token, baseUrl })` 构建一个 `McpServer` 超过一个用户的自动化,绑定在 它被授予无记名代号: 托多主义者OAuth 代号: `automations` 观众,或 托多主义个人信物.

`validateAutomationsToken(token, baseUrl)` 在任何工具运行前对一个符号进行分类, 其中有一个 仅使用状态调用自动化列表 : `valid`, (中文(简体) ), `invalid` (401)或(401) `forbidden` (403个带 `insufficient_scope` (挑战)。 没有这项挑战的403 `valid` 目的:这是一个 拒绝同意不能解除, 如等待列表, 因此每个工具都会显示后端的自身 信件而不是客户端通过 OAuth 循环。 任何其它状态 `TokenValidationError` 从 `@doist/mcp-core/host` 带有该服务器的状态 以5xx作为瞬间. 两个功能都遵循合同 每Doist MCP服务器股份,来自 `@doist/mcp-core/host`。 。 。 .

这是整个公布的表面。 工具本身是针对 `@doist/automations-sdk`,没有发布,所以它们通过服务器得到而不是 出口,而建筑拒绝发出一个让消费者有进口的申报 无法解决问题.

## 聊天转弯

`start-conversation` 财务报告和审定财务报表 `continue-conversation` 每个运行一个持久服务器在工具内转动 电话,路 `tda chat` 在一个过程中执行 : 呼叫块直到代理停止, 代理停止可以使用 分钟后,每10秒报告一次 `notifications/progress` 当客户端 发送了进度符, 或者调试日志消息 。 取消调用中止上游 转弯;部分答复持续 `continue-conversation` 还原它。 共同的逻辑是 `@doist/automations-sdk/chat-turn`,所以CLI和这个软件包不能漂移到如何等待 动作被读取或连接被解决.

## 试验草案

`test-draft` 开始测试运行,除非 `waitMinutes` 是0,民意调查直到结束或等待 每10秒报告一次进展 跑步还在极限 运行和 `get-test-run` 稍后读取; 取消或失败的等待名称 理由,你觉得呢? 开始,投票和结果映射是SDK的 `startDraftTest` 财务报告和审定财务报表 `waitForDraftTest`,与 `tda draft test`。 。 。 .

## 本地运行

没有主机服务器,这里的一切都可以运行在真实的账户上. `AUTOMATIONS_API_KEY` 实值 a Todoist 个人信使或输出 `tda auth token view`· ; `AUTOMATIONS_BASE_URL` 点数 装配或本地后端和默认生产.

```bash
npm run build:core                                   # once, from the monorepo root
npm run build:mcp                                    # produces apps/mcp/dist
npm --workspace=apps/mcp run inspect                 # the MCP inspector over stdio
npm --workspace=apps/mcp run tool -- find-automations '{"limit": 5}'
npm --workspace=apps/mcp run tool -- start-conversation '{"message": "Draft an automation that..."}'
npm --workspace=apps/mcp run tool:list
```

MCP客户端可以直接指向stdio构建,具有相同的环境:

```json
{
    "mcpServers": {
        "automations": {
            "command": "node",
            "args": ["/path/to/automations/apps/mcp/dist/main.js"],
            "env": { "AUTOMATIONS_API_KEY": "..." }
        }
    }
}
```

## 释放

`@doist/automations-mcp` 发表于 `main` 以 [`.github/workflows/release-mcp.yml`](https://npmcn.com/package/.github/workflows/release-mcp.yml),运行中 带有配置的语义释放 [`release.config.js`](https://npmcn.com/package/%40doist/automations-mcp/release.config.js)。该版本 来自于承诺的常规信息 算在这个包,所以 没有东西被手碰上 存储器没有自己的版本号 同样的行为 组成发布通知和通讯通知。 释放到 `latest` dist 标签 : 消费者是主机服务器,它给一个精确的版本插上针. 发布后,工作流程发送 a 一个 `automations-mcp-updated` 发送到 `Doist/todoist-ai-integrations`,其更新工作流程 安装该版本,运行其检查,承诺和重新部署,从而实现释放 `ai.todoist.net` 不等待依赖性公关.

软件包使用的工作空间库不发布, 所以 `npm run build` 将其编译为 `dist/` 并且只有下面的软件包 `dependencies` 保持对外。 这里的任何变化都算数,除了 测试、文件、 `package.json` 字段不会改变安装的内容. `packages/sdk`, (中文(简体) ), `packages/core` 财务报告和审定财务报表 `packages/bitmapist` 与后端和网络应用共享,所以更改 只在犯罪范围广的情况下,才算计在内 `mcp` 或者说 `sdk`。还有任何其他变化 船,与下一次释放。 见 [已发布软件包](https://npmcn.com/package/docs/standards/commit-guidelines.md#published-packages) 如何分开 调取请求,所以每个改变 降落在右释放.

## 添加工具

`src/tool-registry.ts` 是工具表面的单一真理源; 服务器, `run-tool` 以足迹为基准 `src/tool-registry.test.ts` 失败当 视图漂移.

1.  `src/utils/tool-names.ts`:增加名.
2.  `src/tools/<tool-name>.ts`:定义, `satisfies AutomationsTool<...>`复制 `find-automations.ts`。 。 。 .
3.  `src/tool-registry.ts`:将它添加到地图中,在它所属的部分中.
4.  `src/tools/tool-annotations.test.ts`:添加其注释预期.
5.  `src/tools/<tool-name>.test.ts`:对伪造的试验 `AutomationsApi`。 。 。 .
6.  `src/mcp-server.ts`: 添加到 `instructions` 仅当工具需要跨工具路由时 指导;每个工具的细节属于自己的描述.

输出计划从未使用 `.nullable()`: 在 SDK 验证输出前, 空被剥取, 所以 无效字段是等待实现的验证失败。 使用 `.optional()` 离开钥匙 出来. `src/tools/output-schema-nullability.test.ts` 执行它.

`src/token-footprint.test.ts` 打印工具表面对每个模型的成本 `tools/list`如为 变革将合并固定费用推到预算之上,将预算提高到同样的水平,并说到这一点.

## 常见问题

### @doist/automations-mcp 是什么？

用于 Todoist 自动化的 MCP 服务器和可导入的 AI 工具注意：该包已被作者标记为弃用——Moved to @todoist/automations-mcp\. Replace @doist/automations-mcp with @todoist/automations-mcp in your dependencies and imports\.

### 如何安装 @doist/automations-mcp？

在项目目录运行 npm install @doist/automations-mcp，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@modelcontextprotocol/server（^2\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 automations-mcp，可以用 npx automations-mcp 直接运行。

### @doist/automations-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @doist/automations-mcp 支持 ESM 还是 CommonJS？

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

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

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

### @doist/automations-mcp 可以商用吗？

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

### @doist/automations-mcp 的下载量有多少？

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

### @doist/automations-mcp 还在维护吗？

最新版本 2\.2\.0 发布于 2026/11/11（2 天前）；至今共发布 80 个版本，其中过去 12 个月发布了 80 个；首次发布于 2026/09/18。作者已将其标记为弃用，新项目建议寻找替代方案。