# @diskd-ai/email-client-mcp 中文文档

规范地址：https://npmcn.com/package/%40diskd-ai/email-client-mcp/

版本：0\.1\.51
npm 元数据更新时间：2026-09-13T18:11:30.609Z
中文译文更新时间：2026-11-12T11:58:50.867Z
软件包许可：LGPL-3\.0-or-later

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

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

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

- 包体积（解压后）：517 kB，159 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：6 个
- 首次发布：2026-04-29T08:30:02.458Z
- 最新版本发布：2026-09-13T18:11:30.279Z
- 近 30 天下载量：6489（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 47 个）

## 中文简介

驱动支持的多账户邮件 MCP , 并有可靠的 IMAP- to- mailbox 同步 .

## 安装

```sh
npm install @diskd-ai/email-client-mcp
```

也可以使用：`pnpm add @diskd-ai/email-client-mcp`、`yarn add @diskd-ai/email-client-mcp`、`bun add @diskd-ai/email-client-mcp`

## README

# 电子邮件客户端 MCP

多账户电子邮件 MCP 服务器, 有可靠的 IMAP 到 mailbox 同步为 Drive 备份 `messagesStore` (单位:千美元)`@diskd-ai/sdk`) (中文(简体) ). 读取工具点击 IMAP 直播; 监视器在间隔( QQ 60s) 时将每个配置的账户映射到工作空间商店中.

地址: `end:comm/email-client-mcp`。 。 。 .

## 安装

```bash
npx -y @diskd-ai/email-client-mcp stdio
```

服务器在stdio上讲模型背景协议. JSON-RPC在stdout;日志为stderr.

## 工具

从 IMAP 中获取全部读取工具( HODY. PEEK, 从未默默翻转) `\Seen`:

-   `list_accounts` -- 列出已配置的账户( 只配置; 没有 IMAP) .
-   `list_mailbox_folder` -- 账户文件夹, 有可选的未读数和特殊用途旗帜 .
-   `find_mailbox_folder` -- 解析包含给定信件的正则文件夹- ID( 以前使用) `move_email` gmail 虚拟设备).
-   `list_emails` -- 标有过滤器的元数据列表(未读取、标出、调取/调取/标的自此).
-   `get_email` -- UID 的单条消息. 格式 : `raw`, (中文(简体) ), `text` (HTML剥去), `stripped` (也减少引用的答复+签名). `markRead=true` 选入.
-   `get_emails` - 散装变型 `get_email` (最多20个).
-   `move_email` -- IMAP 在文件夹之间移动 。 拒绝虚拟信箱(如:. `[Gmail]/All Mail`) (中文(简体) ).
-   `set_email_attributes` --set read/unread and slang/unflag state for IMAP messages,再补齐 Drive 镜像.
-   `bulk_action` - 说吧 `mark_read | mark_unread | flag | unflag | move | delete` 超过100UID.
-   `get_watcher_status` 同步监视器的内幕快照.

## 监视器可靠性

监视器将 IMAP 同步到工作空间 `messagesStore` 在每一个滴答。 变量 :

1.  `lastSyncedUid` 预付款 **仅限** 在成功之后 `upsertBatch`。 。 。 .
2.  `externalId = "${UIDVALIDITY}:${UID}"` 因此,一个UIDVALIDITY翻滚 从来没有与前一代相撞.
3.  文件夹上的UIDVALIDITIY不匹配触发了干净的滴出+再同步.
4.  每个账户的飞行锁:一个相重叠的勾选被跳过,从未排队.
5.  文件夹元数据是持久的检查点——从那里重新开始恢复,从不从记忆状态恢复.
6.  在 IMAP 中被删除的文件夹会在一勾选尾端从 Drive 中刷出 .
7.  滑动- 窗口旗调和 `flag_reconcile_window` 每勾选一个UID.
8.  在 IMAP 中移动或消失的驱动信件 .

滴答间隔被夹到 QQ 60s .

## 配置

默认路径 : `~/.config/email-client-mcp/config.toml` (通过 `EMAIL_CLIENT_MCP_CONFIG`) (中文(简体) ). 当由mcp-hub部署时,文件由 `diskd-ai/email-client-mcp` 保险库装配器.

```toml
[sdk]
api_key = "..."
base_url = "https://apis.example/"
# workspace_id falls back to MCP_HUB_WORKSPACE_ID env when omitted.

[watcher]
enabled = true
interval_ms = 60000
flag_reconcile_window = 500
# folders = ["INBOX", "Sent"]   # optional allowlist; empty = all

[[accounts]]
name = "work"
email = "you@example.com"
full_name = "You"
password = "..."

[accounts.imap]
host = "imap.example.com"
port = 993
tls = true
verify_ssl = false
```

Gmail OAuth 账户替换 `password` 字段为 `[accounts.oauth2]` 块 :

```toml
[[accounts]]
name = "gmail-work"
email = "you@gmail.com"
full_name = "You"

[accounts.oauth2]
provider = "google"
client_id = "..."
client_secret = "..."
refresh_token = "..."

[accounts.imap]
host = "imap.gmail.com"
port = 993
tls = true
verify_ssl = false
```

## 发展

```bash
bun install
bun run typecheck
bun run lint
bun run test          # vitest unit tests
bun run build         # tsc -> dist/
bun run start         # node dist/server.js stdio (needs config TOML)
bun run dev           # tsx src/server.ts stdio (live reload)

# stdio smoke test (initialize + tools/list + tool calls):
node scripts/smoke.mjs
```

## 释放

自动打印通过 `.github/workflows/release.yml`数字 :

-   **标记驱动** (首选): `npm version patch && git push --follow-tags` 从主 `v*.*.*` 标记触发了输入检查、提示、测试、构建和 `npm publish`对.
-   **一击**: 在 GitHub 动作 UI 中运行 _释放_ 工作流程与 `bump = patch | minor | major`工作颠倒 `package.json`、承诺、标签、推动和出版 -- -- 都是一份工作.

两个路径运行 `bun install --frozen-lockfile`, (中文(简体) ), `bun run typecheck`, (中文(简体) ), `bun run lint`, (中文(简体) ), `bun run test`,以及 `bun run build` 在发布前,启用出处证明.

需要重传密钥 :

| 秘诀 | 目的 |
| --- | --- |
| `NPM_TOKEN` | npmjs.com 颗粒符号,范围 `@diskd-ai/*`, (中文(简体) ), **副通道 2FA** 启用 . |

## 许可证

LGPL-3.0-或-后传. 见 `LICENSE`。 。 。 .

## 常见问题

### @diskd-ai/email-client-mcp 是什么？

驱动支持的多账户邮件 MCP , 并有可靠的 IMAP- to- mailbox 同步 \.

### 如何安装 @diskd-ai/email-client-mcp？

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

### @diskd-ai/email-client-mcp 支持 TypeScript 吗？

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

### @diskd-ai/email-client-mcp 支持 ESM 还是 CommonJS？

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

### @diskd-ai/email-client-mcp 需要什么版本的 Node\.js？

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

### @diskd-ai/email-client-mcp 可以商用吗？

@diskd-ai/email-client-mcp 使用 LGPL-3\.0-or-later 许可。弱 Copyleft：作为库被调用时通常不要求开源你自己的代码，但修改库本身需以 LGPL 开源；前端打包合并后的适用边界存在不同理解。以上为概括，不构成法律意见，请以许可原文为准。

### @diskd-ai/email-client-mcp 的下载量有多少？

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

### @diskd-ai/email-client-mcp 还在维护吗？

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