📧 邮件管理器MCP(v1.1.0)
](https://badge.fury.io/js/@tatine13/mcp-manager)  
基于模型上下文协议的企业级多帐户电子邮件编排
______________________________________________________________________
📋 概述
邮件管理器MCP是最先进、最安全、最适合生产的 模型上下文协议(MCP) 用于电子邮件管理的服务器。专为AI代理(Gemini、Claude、GPT)设计,它将您的邮箱转换为结构化、可搜索和智能的内存库。
它允许像Claude和Cursor这样的人工智能助手管理多个具有高级功能的电子邮件帐户,同时保留您的凭据 超安全.
______________________________________________________________________
🌟 杀手级功能
🔐 通用安全握手(A+B+C)
在任何环境中安全配置任何帐户:
- 方法A(本地):通过本地浏览器快速设置。
- 方法B(直接):用于可信环境的快速注入。
- 方法C(公共隧道):通过安全的临时SSH隧道(Pinggy)配置远程客户端(n8n,移动设备)。
🧠 FTS5本地AI存储器
不要让你的AI淹没在代币中。邮件管理器将您的电子邮件同步到 本地SQLite全文搜索(FTS5) 表:
- 即时搜索:跨所有帐户的亚毫秒级查找。
- 令牌优化:提取干净的文本,删除沉重的HTML和技术标题。
- 依恋意识:AI可以在不获取二进制文件的情况下看到可下载的内容。
🔄 增量同步
智能增量同步逻辑,只获取新内容。
- 演出:首先同步最新的电子邮件,然后在最后一个已知的电子邮件处停止。
- 控制:可配置的限制(默认30,每次会话最多100)。
- 同步状态:查看上次同步的UID、总计数和日期范围
get_sync_status. - 重置同步:清除本地缓存并强制与完全重新同步
reset_sync.
🧵 线程感知智能(v1.1.0)
智能对话线程,用于上下文丰富的AI回复:
- 线程检测:通过自动检测对话
Message-ID,In-Reply-To,以及References标题。 - 线程抓取:
get_email_thread按时间顺序检索对话中的所有电子邮件。 - 线程摘要:
get_thread_summary生成简明摘要(关键参与者、主题、时间线)。 - 自动上下文注入:回复
thread_aware: true自动将线程历史记录注入到您的回复正文中。
📜 360°活动审核
对用户和人工智能都是完全透明的。每个操作都记录在一个专门的活动日志中:
- 读取/发送:确切知道访问或发送了什么。
- 同步/下载:跟踪后台内存更新和文件传输。
- 任务/指令:监控自动化工作流程。
______________________________________________________________________
🚀 安装
选项1:全局安装(NPM)
npm install -g @tatine13/mcp-manager选项2:本地安装(开发)
git clone https://github.com/Tatine13/mailing-manager-mcp.git
cd mailing-manager-mcp
npm install
npm run build🗝️ 首次设置
创建加密密码(用于保护本地SQLite数据库):
# Set your unlock code in your environment
export MAILING_MANAGER_UNLOCK_CODE="your-secure-password"
# Run the setup wizard
mailing-manager setup
# (Or 'node dist/bin/cli.js setup' if running locally)______________________________________________________________________
⚙️ 配置
将邮件管理器添加到MCP客户端(Gemini CLI、Claude Desktop或Cursor)。
A.使用NPM(最简单)
{
"mcpServers": {
"mailing-manager": {
"command": "npx",
"args": ["-y", "@tatine13/mcp-manager", "server"],
"env": {
"MAILING_MANAGER_UNLOCK_CODE": "your-secure-password",
"MAILING_MANAGER_SYNC_LIMIT": "50",
"LOG_LEVEL": "info"
}
}
}
}B.使用本地构建
{
"mcpServers": {
"mailing-manager": {
"command": "node",
"args": ["/ABS_PATH_TO_PROJECT/dist/bin/server.js"],
"env": {
"MAILING_MANAGER_UNLOCK_CODE": "your-secure-password",
"MAILING_MANAGER_SYNC_LIMIT": "50"
}
}
}
}______________________________________________________________________
📬 多账户支持
- 无限电子邮件帐户
- 提供商预设:Gmail、Outlook、雅虎、iCloud、Fastmail、自定义
- 身份验证方法:应用程序密码,密码(计划在v1.5中支持OAuth2)
- 协议:IMAP、带TLS的SMTP
______________________________________________________________________
🛠️ 可用工具(38)
👤 账户和提供商管理
| 工具 | 说明 |
|---|---|
add_account | 通过Direct、Local或Public隧道添加新的电子邮件帐户。 |
list_accounts | 列出所有已配置的电子邮件帐户。 |
remove_account | 删除电子邮件帐户。 |
test_connection | 测试与电子邮件帐户的连接。 |
add_provider_preset | 添加或更新电子邮件提供商预设。 |
list_provider_presets | 列出所有可用的电子邮件提供商预设。 |
vault_status | 检查服务器保管库是否已解锁并准备就绪。 |
📧 电子邮件操作(IMAP/SMTP)
| 工具 | 说明 |
|---|---|
list_emails | 列出帐户文件夹中的电子邮件。 |
read_email | 阅读完整的干净内容(无Base64垃圾邮件)。 |
send_email | 发送电子邮件(支持本地附件、线程感知回复)。 |
search_emails | 跨文件夹搜索电子邮件(联机)。 |
get_email_thread | 获取对话线程中的所有电子邮件(通过消息ID/引用)。 |
get_thread_summary | 获取AI上下文的简明线程摘要。 |
move_email | 将电子邮件移动到另一个文件夹。 |
delete_email | 删除电子邮件。 |
download_attachment | 下载本地资产的附件。 |
🧠 本地内存和审计
| 工具 | 说明 |
|---|---|
sync_emails | 将最近的电子邮件拉入本地FTS5数据库。 |
search_local_emails | 同步电子邮件中的快速离线搜索(FTS5)。 |
get_sync_status | 查看同步状态(最后一个UID、总计数、日期范围)。 |
reset_sync | 清除本地缓存并强制完全重新同步。 |
get_email_history | 所有操作的历史记录(读取、发送、同步、下载)。 |
get_server_info | 获取服务器版本和环境信息。 |
🎭 AI角色
| 工具 | 说明 |
|---|---|
create_persona | 为自动化处理创建一个新的AI角色。 |
list_personas | 列出一个帐户的所有角色。 |
update_persona | 更新现有角色。 |
delete_persona | 删除角色。 |
📋 自动化指令
| 工具 | 说明 |
|---|---|
create_directive | 创建自动化指令(规则)。 |
list_directives | 列出帐户的指令。 |
test_directive | 测试哪些指令与特定电子邮件匹配。 |
delete_directive | 删除指令。 |
⚙️ 计划任务
| 工具 | 说明 |
|---|---|
create_task | 创建计划任务(Cron/Interval)。 |
list_tasks | 列出所有任务。 |
execute_task | 立即手动执行任务。 |
delete_task | 删除任务。 |
🔗 网络钩子
| 工具 | 说明 |
|---|---|
create_inbound_webhook | 创建一个端点以接收外部Webhook。 |
create_outbound_webhook | 创建一个webhook来通知外部系统。 |
list_webhooks | 列出已配置的webhooks。 |
webhook_logs | 查看webhook的执行日志。 |
______________________________________________________________________
🛡️ 安全第一
- AES-256-GCM:凭据从不以明文形式存储。
- Argon2d:军用级密钥派生。
- 保险库架构:非阻塞协议稳定性。
- 安全输入:基于浏览器的临时安全门户。
______________________________________________________________________
📄 许可证
MIT© 塔廷13
Made with ❤️ for the AI-powered future of email management
