邮件协议服务器

一个基于IMAP和SMTP协议的模型上下文协议(MCP)服务器,用于模型助手访问和交互电子邮件账户。

  • by gabigabogabu
  • TypeScript
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 gabigabogabu/email-mcp-server

使用说明

电子邮件MCP服务器

使用IMAP和SMTP协议进行电子邮件集成的模型上下文协议(MCP)服务器。此服务器允许模型助手访问电子邮件帐户并与之交互。

特性

  • 从IMAP邮箱读取电子邮件
  • 通过SMTP发送电子邮件
  • 搜索电子邮件
  • 列出电子邮件文件夹

先决条件

  • Node.js(v16或更高版本)
  • npm或纱线
  • 具有IMAP和SMTP访问权限的电子邮件帐户

设置

  1. 克隆存储库:

    git clone <repository-url>
    cd imap-mcp
    
  2. 安装依赖项:

    npm install
    
  3. 创建一个 .env 根目录中的文件,包含以下变量:

    EMAIL_USER=your-email@example.com
    EMAIL_PASSWORD=your-password
    IMAP_HOST=imap.example.com
    IMAP_PORT=993
    SMTP_HOST=smtp.example.com
    SMTP_PORT=465
    

用法

发展

要在开发模式下运行服务器,请执行以下操作:

npm run dev

这将监视更改,重新编译TypeScript,并自动重新启动服务器。

生产

要在生产模式下构建和运行服务器,请执行以下操作:

npm run build
npm start

API

服务器公开以下MCP资源:

  • mailto:<email-address>/inbox -收件箱中最近10封电子邮件的列表
  • mailto:<email-address>/folders -电子邮件文件夹/邮箱列表

以及以下MCP工具:

  • send_email -发送电子邮件
  • search_emails -使用高级查询选项搜索电子邮件
  • list_folders -列出所有可用的电子邮件文件夹/邮箱

许可证

ISC许可证-请参阅 许可证 详见