Skip to main content
Glama
deenesjakoruzh
gexiro-global

MailBridge MCP

by gexiro-global
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

MailBridge MCP

MailBridge MCP — read-only email intelligence

CI Container CodeQL Release License

面向 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: imap-2-mcp

工具集

工具

用途

list_mailboxes

发现合成邮箱和安全元数据。

mailbox_health

报告经过编辑的 TLS/认证/文件夹/只读健康状态。

list_folders

枚举可选择的文件夹和计数器。

list_recent_messages

返回有界的最新消息元数据。

search_messages

结构化的多邮箱、全文件夹搜索。

fetch_message

获取一条有界消息，不改变未读状态。

fetch_thread

从消息标识符重建线程。

list_attachments

仅返回附件元数据。

fetch_attachment

返回有界的合成字节、base64 和 SHA-256。

search

标准只读知识搜索。

fetch

标准只读知识文档获取。

每个描述符都设置 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 元数据不声明任何外部连接或资源域。

官方参考：

发布完整性

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

项目政策

许可证

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-imap-server

    mattias242
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables LLMs to read, search, and manage emails via IMAP with secure, read-only access to email accounts.
    6
    -

  • imap-2-mcp

    hugoheinzson
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI clients to search IMAP mailboxes with live access and a full-text index covering email bodies and attachments (PDF, DOCX, XLSX, text).
    -

  • imap-mcp

    jonathanhowell
    A
    license
    Not graded
    quality
    D
    maintenance
    Read-only MCP server for IMAP email access, enabling AI agents to read, search, and monitor email without sending or deleting messages.
    24 npm
    MIT

  • postfach-mcp

    unstko
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to securely access IMAP mailboxes with read-focused tools for searching, reading, listing messages, and creating drafts, while deliberately preventing sending or deleting emails.
    MIT