返回 MCP 目录
public公开dns本地运行

IMAP Workflows

一个基于MCP协议的IMAP邮件服务器,为AI助手提供邮件检查、处理和用户偏好学习功能。

article

README

🚀 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 模型。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端