de en es ja ko ru zh

MailBridge MCP

Name: MailBridge MCP
Author: gexiro-global

by gexiro-global

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

MailBridge MCP

Container CodeQL Release License

セキュリティ最優先の読み取り専用メールインテリジェンスを、MCP 対応の AI アシスタントに提供します。

MailBridge は、AI アシスタントが複数のメールボックスを検索し、スレッドを再構築し、添付ファイルを検査し、メールボックスの状態を保持できるようにするデモンストレーションです。公開配布版は完全に合成データで動作するため、実際の認証情報や実在の受信トレイにアクセスすることなく、安全に探索できます。

このリポジトリは、Gexiro Global Enterprises Ltd. による管理された公開リファレンス配布物です。プライベートなデプロイ環境のミラーではなく、本番環境の設定、インフラストラクチャ、メールボックスデータ、認証情報は一切含まれていません。

MailBridge を選ぶ理由

意図的に読み取り専用に設計された 11 個の MCP ツール。
ナレッジソース互換性のための標準的な search および fetch コントラクト。
すべての構造化ツール結果に対する明示的な出力スキーマ。
バージョン管理された ui:// リソースを備えた MCP Apps ウィジェット。
標準準拠の ui/initialize および ui/notifications/initialized ハンドシェイク。
複数メールボックスおよび全フォルダーにわたる検索動作。
Message-ID、In-Reply-To、References を使用したスレッド再構築。
SHA-256 チェックサムによる境界付き添付ファイル取得。
メールおよび添付ファイルのコンテンツが信頼できないものであることを明示的に警告。
フェイルクローズドなパブリックバインディング: オペレーターが明示的に許可しない限り、ループバックのみ。
SMTP 送信、移動、削除、フラグ付け、追加、コピー、EXPUNGE 操作は一切行いません。

Related MCP server: imap-2-mcp

ツールサーフェス

ツール	目的
`list_mailboxes`	合成メールボックスと安全なメタデータを検出します。
`mailbox_health`	編集済みの TLS/認証/フォルダー/読み取り専用状態を報告します。
`list_folders`	選択可能なフォルダーとカウンターを列挙します。
`list_recent_messages`	境界付きの最近のメッセージメタデータを返します。
`search_messages`	構造化された複数メールボックス、全フォルダー検索を実行します。
`fetch_message`	未読状態を変更せずに、境界付きのメッセージ 1 件を取得します。
`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]

プロバイダー境界は意図的に小さく保たれています。この公開版には合成プロバイダーのみが同梱されており、本番環境用アダプター、オペレーター ID、認証情報ストレージ、デプロイメントトポロジーは、このリポジトリの範囲外です。

セキュリティプロパティ

どの 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 の成果物証明書をこのリポジトリに対して検証してください。

プロジェクトポリシー

ライセンス

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

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

email A
dev.primitive
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email Communication
142
AgentMailOAuth
to.agentmail
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Email Communication
2
Sickle — every mailbox for your agentOAuth
app.sickle
Gmail, Outlook, iCloud, Fastmail and any IMAP mailbox for your agent. Scoped OAuth, no send tool.
Email Communication
1
Lettio MCPOAuth
eu.lettio
Private, EU-hosted email for AI agents over JMAP: read, search, reply, organize, send.
Email App Automation
1

Related MCP Servers

mcp-imap-server
Email Communication
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.
Updated a year ago (2025-11-15 09:59 UTC)
6
-
imap-2-mcp
Email Search
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).
Updated 16 days ago (2026-09-29 17:47 UTC)
-
imap-mcp
Email Communication
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.
Updated 4 months ago (2026-06-14 15:24 UTC)
24 npm
MIT
postfach-mcp
Email Communication
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.
Updated a month ago (2026-09-10 13:43 UTC)
MIT

MailBridge MCP

MailBridge を選ぶ理由

ツールサーフェス

クイックスタート

Docker

アーキテクチャ

セキュリティプロパティ

OpenAI Apps SDK との整合性

リリースの整合性

プロジェクトポリシー

ライセンス

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-imap-server

imap-2-mcp

imap-mcp

postfach-mcp