MCP Mail · bwb.pt

面向 Claude.ai 的自托管 claude-mail-mcp 连接器，具有：

• OAuth 2.1 + DCR + PKCE shim (Claude.ai Custom Connector)

• 管理后台位于 https://mcp-mail.bwb.pt/admin，用于多账户 IMAP/SMTP 管理

• 基于 Ubuntu 24.04 的加固 nginx + systemd

架构

Claude.ai ──HTTPS/OAuth──▶ nginx (mcp-mail.bwb.pt)
                              ├─ /health  → claude-mail-mcp :3220
                              └─ /*       → oauth-shim+admin :3221 ──Bearer──▶ :3220

Related MCP server: Gmail MCP Server

本地开发

cp deploy/env/shim.env.example .env
# adjust STATE_DIR to a local path, SESSION_SECRET, AUTH_TOKEN
npm install
npm run build
npm start

生产部署

在 VPS 上（以 root 身份），在本仓库检出目录中：

bash deploy/install.sh

然后打开 https://mcp-mail.bwb.pt/admin，登录，更改临时密码，添加邮箱账户。

Claude.ai → 设置 → 连接器 → 添加自定义 → URL https://mcp-mail.bwb.pt/mcp。

运维

参见 docs/OPERATIONS.md 和 docs/ROADMAP.md。