AI导哈

邮件发送服务

一个基于Python的企业微信邮件API服务端，用于发送普通邮件，支持多种传输方式和邮件格式。

  • by aiguicai
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 510myRday/wecom-mail-mcp

使用说明

WeCom Mail MCP

一个基于 Python 的 MCP 服务端，通过企业微信官方邮件 API 发送普通邮件。

它做的事情很简单：

  • 对 AI 暴露 send_email
  • 通过企业微信官方接口发送邮件
  • 从环境变量或 .env 读取 CORPID / CORPSECRET
  • 兼容 uv run 和 uvx --from ...

功能

  • 官方 WeCom 邮件 API 发信，不走 SMTP
  • 自动获取并缓存 access_token
  • 兼容 text / html，也兼容 text/plain / text/html
  • 提供 get_mailbox_info，方便确认当前发件邮箱
  • 支持 stdio、sse、streamable-http 三种传输方式

你需要先准备什么

在企业微信侧确认下面几件事：

  1. 有可用的 CORPID
  2. 有对应应用的 CORPSECRET
  3. 应用具备“邮件”权限
  4. 应用邮箱账号已经配置好
  5. 调用邮件接口所用的应用 secret 已经在“可调用应用”范围内

官方文档：

环境变量 / .env

服务端会自动加载项目根目录下的 .env。 优先级是：命令行覆盖 > .env > 系统环境变量。 也就是说，.env 里写了就以 .env 为准；.env 没写或留空时，再回退到系统环境变量。

必填：

  • WECOM_CORP_ID
  • WECOM_CORP_SECRET

兼容别名：

  • CORPID
  • CORPSECRET

可选：

  • WECOM_API_BASE，默认 https://qyapi.weixin.qq.com
  • WECOM_REQUEST_TIMEOUT，默认 20
  • WECOM_MCP_TRANSPORT，默认 stdio
  • WECOM_MCP_HOST，默认 127.0.0.1
  • WECOM_MCP_PORT，默认 8000
  • WECOM_LOG_LEVEL，默认 INFO

本地运行

1. 安装依赖

uv sync

2. 配置 .env

项目里已经提供了 .env.example 和一个本地 .env 模板。

PowerShell 以外，最省事的方式就是直接编辑根目录 .env：

CORPID=你的企业ID
CORPSECRET=你的应用Secret

如果你不想用 .env，也可以继续用系统环境变量。

3. 或者设置环境变量

PowerShell:

$env:CORPID="你的企业ID"
$env:CORPSECRET="你的应用Secret"

4. 校验配置

uv run wecom-mail-mcp --check-config

成功时会输出当前应用邮箱账号和别名邮箱列表。

5. 以 stdio 启动 MCP

uv run wecom-mail-mcp

uvx 可以吗

可以。对于 Python 项目，uvx 的角色基本就类似 Node 生态里的 npx。

本项目已经提供了 console script，所以本地目录可以直接这样跑：

uvx --from . wecom-mail-mcp

如果以后你把它发到 PyPI，上线后就可以直接：

uvx wecom-mail-mcp

Claude Desktop 配置示例

{
  "mcpServers": {
    "wecom-mail": {
      "command": "uvx",
      "args": [
        "--from",
        "d:/Code_Save/Py/发邮件的mcp",
        "wecom-mail-mcp"
      ],
      "env": {
        "CORPID": "你的企业ID",
        "CORPSECRET": "你的应用Secret"
      }
    }
  }
}

如果你更喜欢 uv run，也可以：

{
  "mcpServers": {
    "wecom-mail": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "d:/Code_Save/Py/发邮件的mcp",
        "wecom-mail-mcp"
      ],
      "env": {
        "CORPID": "你的企业ID",
        "CORPSECRET": "你的应用Secret"
      }
    }
  }
}

MCP 工具

send_email

参数：

  • to_email：收件人邮箱
  • subject：邮件主题
  • content：邮件正文
  • content_type：可选，支持 text、html、text/plain、text/html，默认 text

说明：

  • 发件人不是由 AI 传入的，而是企业微信“应用邮箱账号”
  • 服务端会把 text/plain 映射为官方接口的 text
  • 服务端会把 text/html 映射为官方接口的 html
  • 如果发送 HTML，请显式传 content_type="html"
  • MCP 工具描述会直接告知客户端 HTML 邮件兼容限制，避免把网页模板直接当邮件模板发送

HTML 邮件兼容建议

如果要发 HTML 邮件，按最保守的邮件写法来：

  • 优先使用 table、tbody、tr、td 做布局
  • 文本和基础内容只用 p、br、span、strong、b、em、i、h1 到 h4、a、img
  • 样式尽量写成 inline style，不要依赖复杂选择器
  • 图片使用公网 https 绝对地址

尽量避免：

  • script、iframe、form、video、audio、canvas、svg
  • 外链 CSS、Web Font
  • flex、grid、position
  • 相对路径、本地路径、网页式复杂模板

推荐骨架：

<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr>
    <td>
      <h2 style="margin:0 0 16px;">标题</h2>
      <p style="margin:0 0 12px;">正文</p>
      <a href="https://example.com">链接</a>
      <img
        src="https://example.com/demo.png"
        alt=""
        style="display:block;width:100%;height:auto;border:0;"
      >
    </td>
  </tr>
</table>

get_mailbox_info

返回当前应用邮箱账号与别名邮箱列表，便于确认发件人身份。

HTTP 模式

如果你要用 HTTP 传输：

uv run wecom-mail-mcp --transport streamable-http --host 127.0.0.1 --port 8000

开发测试

python -m unittest discover -s tests

相关 MCP