MailBridge MCP

面向 MCP 兼容 AI 助手的、安全至上的只读电子邮件智能。

MailBridge 演示了 AI 助手如何搜索多个邮箱、重建邮件线程、检查附件并保持邮箱状态不变。公开分发版完全运行在合成数据上，因此无需凭据或访问真实收件箱即可安全探索。

本仓库是 Gexiro Global Enterprises Ltd. 的受控公开参考分发版。它不是任何私有部署的镜像，也不包含任何生产配置、基础设施、邮箱数据或凭据。

为什么选择 MailBridge

• 十一个刻意设计为只读的 MCP 工具。

• 标准 search 和 fetch 契约，确保知识源兼容性。

• 为每个结构化工具结果提供显式输出模式。

• 带有版本化 ui:// 资源的 MCP Apps 小部件。

• 标准优先的 ui/initialize 和 ui/notifications/initialized 握手。

• 多邮箱和全文件夹搜索行为。

• 使用 Message-ID、In-Reply-To 和 References 重建邮件线程。

• 带 SHA-256 校验和的有界附件检索。

• 明确警告电子邮件和附件内容不受信任。

• 故障时默认关闭的公共绑定：除非操作员明确选择，否则仅限回环。

• 零 SMTP、发送、移动、删除、标记、追加、复制或清除操作。

Related MCP server: Outlook MCP Server

工具集

每个描述符都设置 readOnlyHint: true、destructiveHint: false、idempotentHint: true 和 openWorldHint: false。

快速开始

要求：Node.js 24 或更高版本。

npm ci
npm run check
npm run dev

服务器默认在回环地址上启动：

Health: http://127.0.0.1:3100/health
Widget: http://127.0.0.1:3100/widget
MCP:    http://127.0.0.1:3100/mcp

要从 MCP 客户端连接，请使用可流式传输的 HTTP 端点 /mcp。对于 ChatGPT 开发者测试，请通过经过审查的 HTTPS 隧道公开回环服务，并在工具或资源元数据更改后刷新应用。

Docker

该容器仍然仅包含合成数据，并以非特权 node 用户身份运行。

docker build -t mailbridge-mcp .
docker run --rm -p 127.0.0.1:3100:3100 \
  -e MAILBRIDGE_HOST=0.0.0.0 \
  -e MAILBRIDGE_ALLOW_PUBLIC_DEMO=I_UNDERSTAND_SYNTHETIC_ONLY \
  mailbridge-mcp

架构

flowchart LR
    Host[ChatGPT or MCP host] -->|Streamable HTTP| MCP[MailBridge MCP server]
    MCP --> Tools[Read-only tool contracts]
    MCP --> Widget[MCP Apps dashboard]
    Tools --> Demo[Synthetic mailbox provider]
    Demo --> Guard[Untrusted-content and size guards]

提供程序边界刻意保持很小。此公开版仅包含合成提供程序；生产适配器、操作员身份、凭据存储和部署拓扑均不在此仓库中。

安全属性

• 任何 MCP 工具模式中都不存在凭据输入。

• 此公开分发版未实现真实的邮箱连接。

• 消息获取不会改变合成的未读状态。

• 附件字节数有界，并标记为不受信任。

• 除非设置了显式的合成演示确认，否则 HTTP 运行时拒绝非回环绑定。

• CI 运行编译、测试、仓库密钥扫描、依赖项审计、依赖项审查、CodeQL、真实容器冒烟测试和 SBOM 验证。

• 容器门禁在检测到高或严重 CVE 时默认失败，并在依赖项安装后从运行时镜像中移除包管理器。

• 标记的版本包含 SHA-256 校验和、CycloneDX SBOM 和 GitHub 工件来源证明。

请参阅 SECURITY.md、THREAT_MODEL.md、PRIVACY.md 和 ARCHITECTURE.md。

OpenAI Apps SDK 对齐

该实现遵循当前的 MCP Apps 优先指南：

• UI 资源使用 text/html;profile=mcp-app；

• 没有小部件时工具仍然有用；

• list_mailboxes 指向版本化的 _meta.ui.resourceUri；

• 该小部件使用 ui/notifications/tool-result，并且仅将 window.openai.toolOutput 用作兼容性路径；

• CSP 元数据不声明任何外部连接或资源域。

官方参考：

• 构建 MCP 服务器

• 向 MCP 服务器添加 UI

• 定义工具

• 插件参考

发布完整性

每个标记的版本都由 GitHub Actions 中的锁定依赖项构建。使用随附的 SHA256SUMS 验证下载的存档和 SBOM，然后在使用前对照此仓库验证 GitHub 工件证明。

项目政策

• 变更日志

• 贡献指南

• 行为准则

• 支持

• 安全

• 隐私

许可证

Apache License 2.0. Copyright © 2026 Gexiro Global Enterprises Ltd.