内容
# 邮件管理工具
> 基于 [davidvornholt/standards](https://github.com/davidvornholt/standards) 构建。
一个仅用于草稿的 IMAP 助手，用于 Thunderbird 工作流程，通过 MCP 服务器向 Codex、Claude 和其他兼容的客户端公开，并通过共享的效果核心为您提供 `邮件` CLI 命令行界面。通过 MCP 服务器，它可以搜索和读取邮件，创建、更新或删除带有 HTML 和附件的草稿；`邮件` CLI 命令行界面涵盖登录、状态、文件夹/搜索/读取和纯文本草稿创建。它无法发送电子邮件：草稿同步到 Thunderbird 进行审查和发送。
## 布局
```
apps/mail 应用程序（MCP 服务器 + CLI 命令行界面）
src/app 入口点：server.ts（MCP 服务器，标准输入/输出），cli.ts（`邮件` 命令行界面）
src/features/mail 模式、标记错误和效果服务（配置、机密、状态、IMAP、草稿、登录）
src/shared 应用程序本地基础设施（参数解析、隐藏输入终端提示）
packages/* 从标准模板同步的规范共享配置
```
请参阅 [`apps/mail/README.md`](apps/mail/README.md) 以获取工具列表、配置和机密处理。
## 设置
```bash
bun install
# 将 `邮件` 命令添加到您的 PATH 中（一次性；链接应用程序的二进制文件到 ~/.bun/bin）。之后，从任何地方运行 `邮件 …`。
bun link --cwd apps/mail
# 配置您的帐户（非机密：地址、IMAP 主机和端口）。实际文件被 git 忽略，因此您的地址永远不会进入 git。
cp apps/mail/accounts.example.toml apps/mail/accounts.toml
# …编辑 apps/mail/accounts.toml…
# 验证每个帐户的密码与 IMAP，然后将其存储在操作系统密钥环中（隐藏提示 - 不会回显或写入磁盘）。请您自己运行此命令；机密永远不会离开您的机器。
邮件 登录 you@example.com
# 确认每个帐户都正确身份验证（或显示仍需要登录的内容）
邮件 状态
```
将 MCP 服务器注册到 Codex：
```bash
codex mcp add 邮件 -- bun run <repo>/apps/mail/src/app/server.ts
codex mcp get 邮件
```
Codex 将 MCP 工具定义延迟到它们相关时，因此注册服务器不会急切地将每个邮件工具模式添加到模型上下文中。在添加完成后重启 Codex，然后使用 `/mcp` 检查连接的服务器。
对于显式写入审批和更多的 IMAP 操作空间，请编辑 `~/.codex/config.toml` 中生成的条目：
```toml
[mcp_servers.邮件]
命令 = "bun"
参数 = ["run", "<repo>/apps/mail/src/app/server.ts"]
启动超时秒 = 15
工具超时秒 = 120
默认工具审批模式 = "写入"
[mcp_servers.邮件.工具.delete_draft]
审批模式 = "提示"
```
对于 Claude 代码（用户范围），使用：
```bash
claude mcp add --scope user 邮件 -- bun run <repo>/apps/mail/src/app/server.ts
```
一旦存储了密码，请要求您的 MCP 客户端搜索您的邮件或撰写草稿。您也可以自己驱动先审查的 CLI 命令行界面：
```bash
邮件 搜索 you@example.com 发票
```
不需要链接全局命令？所有示例也适用于 `bun run apps/mail/src/app/cli.ts <参数>`。
## 需求
- Bun（参见 `package.json` 中的 `packageManager`）。
- 运行中的、解锁的秘密服务提供程序（gnome-keyring），用于操作系统密钥环。
## 质量门控
`bun run check` 运行标准漂移检查，然后进行 lint、类型检查、测试、构建和整个工作区的无障碍检查。更改完成前必须通过此检查。
