IMAP Workflows

🚀 IMAP MCP 服务器

IMAP MCP 服务器实现了模型上下文协议（MCP），可与邮件服务器进行交互。它为 AI 模型提供了一个灵活且可扩展的框架，使其能通过 MCP 协议与电子邮件系统通信，极大提升了 AI 与邮件系统的交互效率。

🚀 快速开始

先决条件

• Python 3.8 或更高版本
• IMAP 邮件账户凭据
• 安装依赖项：pip install python-imaplib

安装

1. 克隆仓库：

   git clone https://github.com/yourusername/imaps_mcp_server.git
   cd imaps_mcp_server
   

2. 安装依赖：

   pip install -r requirements.txt
   

配置示例

编辑config/settings.py以配置邮件账户和其他设置。

✨ 主要特性

基本特性

• IMAP 集成：支持与 IMAP 邮件服务器的通信。
• 邮件资源：实现 MCP 协议中定义的邮件资源接口。
• 邮件工具：提供用于操作邮件的工具，如发送、删除和标记。

高级特性

• 用户偏好学习：通过分析用户的交互行为，自动调整邮件处理策略。
• 多账户支持：允许同时管理多个电子邮件账户。
• 高级搜索：支持复杂的邮件搜索条件，包括主题、发件人和附件类型。

📦 安装指南

安装步骤

1. 克隆仓库：

   git clone https://github.com/yourusername/imaps_mcp_server.git
   cd imaps_mcp_server
   

2. 安装依赖：

   pip install -r requirements.txt
   

💻 使用示例

基础用法

目前文档未提供基础用法的代码示例，后续可根据实际情况补充。

高级用法

目前文档未提供高级用法的代码示例，后续可根据实际情况补充。

📚 详细文档

当前项目结构

项目的目录结构如下：

imaps_mcp_server/
├── config/           # 配置文件和环境变量
├── resources/       # MCP 协议定义的资源实现
├── tools/           # 邮件操作工具
├── server.py        # 主服务器文件
└── README.md         # 项目文档

开发

设置开发环境

1. 创建虚拟环境：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上使用：venv\Scripts\activate
   

2. 安装开发依赖：

   pip install -e ".[dev]"
   

运行测试

pytest tests/

安全考虑

• 使用环境变量或安全的凭证存储来管理邮件凭据。
• 考虑使用应用专用密码而非主账户密码。
• 限制对邮件服务器的访问权限，仅授予必要的权限。

项目路线图

已完成任务

• 项目初始化和仓库设置
• 基本 IMAP 集成
• 邮件资源实现
• 邮件工具实现

计划中任务

• 用户偏好学习实现
• 高级搜索功能
• 多账户支持
• 支持主流邮件提供商

贡献指南

欢迎贡献！请参考CONTRIBUTING.md获取详细说明。

📄 许可证

此项目遵循 MIT 许可证，具体内容见LICENSE文件。

鸣谢

感谢以下项目的贡献：

• 模型上下文协议（Model Context Protocol）提供了实现框架。
• Anthropic 公司开发了 Claude 模型。