🚀 IMAP MCP 服务器

本项目是一个实现模型上下文协议（MCP）的IMAP服务器，可助力AI模型通过MCP协议与电子邮件系统进行通信，为其提供了灵活且可扩展的交互框架。

🚀 快速开始

先决条件

• 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协议中定义的邮件资源接口。
• 邮件工具：提供用于操作邮件的工具，如发送、删除和标记。

高级特性

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

📦 安装指南

克隆仓库

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

安装依赖

pip install -r requirements.txt

📚 详细文档

项目概述

此IMAP MCP服务器允许AI模型通过MCP协议与电子邮件系统进行交互。它支持以下功能：

• IMAP协议集成
• 邮件资源管理
• 邮件操作工具
• 邮件草稿和回复功能
• 高级搜索能力

当前项目结构

项目的目录结构如下：

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获取详细说明。

鸣谢

感谢以下项目的贡献：

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

📄 许可证

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