mcp-email-server

通过MCP服务器实现IMAP和SMTP

• GitHub仓库: https://github.com/ai-zerolab/mcp-email-server/
• 文档: https://ai-zerolab.github.io/mcp-email-server/

安装

手动安装

我们推荐使用 uv 来管理您的环境。

尝试 uvx mcp-email-server@latest ui 进行配置，并使用以下配置用于mcp客户端：

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

此包在PyPI上可用，因此您可以使用 pip install mcp-email-server 进行安装。

之后，使用UI配置您的电子邮件服务器：mcp-email-server ui

环境变量配置

您还可以使用环境变量来配置电子邮件服务器，这对于像Jenkins这样的CI/CD环境特别有用。zerolib-email支持UI配置（通过TOML文件）和环境变量，其中环境变量优先级更高。

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "work",
        "MCP_EMAIL_SERVER_FULL_NAME": "John Doe",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "john@example.com",
        "MCP_EMAIL_SERVER_USER_NAME": "john@example.com",
        "MCP_EMAIL_SERVER_PASSWORD": "your_password",
        "MCP_EMAIL_SERVER_IMAP_HOST": "imap.gmail.com",
        "MCP_EMAIL_SERVER_IMAP_PORT": "993",
        "MCP_EMAIL_SERVER_SMTP_HOST": "smtp.gmail.com",
        "MCP_EMAIL_SERVER_SMTP_PORT": "465"
      }
    }
  }
}

可用的环境变量

变量	描述	默认值	必需
MCP_EMAIL_SERVER_ACCOUNT_NAME	账户标识符	"default"	否
MCP_EMAIL_SERVER_FULL_NAME	显示名称	邮件前缀	否
MCP_EMAIL_SERVER_EMAIL_ADDRESS	邮件地址	-	是
MCP_EMAIL_SERVER_USER_NAME	登录用户名	与邮件相同	否
MCP_EMAIL_SERVER_PASSWORD	邮件密码	-	是
MCP_EMAIL_SERVER_IMAP_HOST	IMAP服务器主机	-	是
MCP_EMAIL_SERVER_IMAP_PORT	IMAP服务器端口	993	否
MCP_EMAIL_SERVER_IMAP_SSL	启用IMAP SSL	true	否
MCP_EMAIL_SERVER_SMTP_HOST	SMTP服务器主机	-	是
MCP_EMAIL_SERVER_SMTP_PORT	SMTP服务器端口	465	否
MCP_EMAIL_SERVER_SMTP_SSL	启用SMTP SSL	true	否
MCP_EMAIL_SERVER_SMTP_START_SSL	启用STARTTLS	false	否

对于独立的IMAP/SMTP凭据，您也可以使用：

• MCP_EMAIL_SERVER_IMAP_USER_NAME / MCP_EMAIL_SERVER_IMAP_PASSWORD
• MCP_EMAIL_SERVER_SMTP_USER_NAME / MCP_EMAIL_SERVER_SMTP_PASSWORD

然后您可以在 Claude Desktop 中试用它。如果您想将其集成到其他mcp客户端中，请运行 $which mcp-email-server 获取路径并在您的客户端中进行如下配置：

{
  "mcpServers": {
    "zerolib-email": {
      "command": "{{ ENTRYPOINT }}",
      "args": ["stdio"]
    }
  }
}

如果 docker 可用，您可以尝试使用Docker镜像，但您可能需要通过 MCP 的 tools 在您的客户端中进行配置。默认配置路径是 ~/.config/zerolib/mcp_email_server/config.toml

{
  "mcpServers": {
    "zerolib-email": {
      "command": "docker",
      "args": ["run", "-it", "ghcr.io/ai-zerolab/mcp-email-server:latest"]
    }
  }
}

通过Smithery安装

要通过 Smithery 自动为Claude Desktop安装电子邮件服务器：

npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude

开发

该项目使用 uv 进行管理。

尝试 make install 来安装虚拟环境并安装预提交钩子。

使用 uv run mcp-email-server 进行本地开发。

发布新版本

• 在 PyPI 上创建一个API令牌。
• 将API令牌添加到项目的密钥中，命名为 PYPI_TOKEN，访问 此页面。
• 在GitHub上创建一个 新版本。
• 创建一个新的标签，格式为 *.*.*。

更多详情，请参阅 这里。