Jmap MCP

🚀 JMAP MCP Server

JMAP（JSON Meta Application Protocol）メールサーバーとのやり取りに必要なツールを提供する、Model Context Protocol（MCP）サーバーです。Denoを使用して構築され、[@htunnicliff/jmap - jam](https://jsr.io/@htunnicliff/jmap - jam) クライアントライブラリを利用しています。

✨ 主な機能

メール管理ツール

• メール検索：テキストクエリ、送信者/受信者フィルター、日付範囲、キーワードを使ってメールを検索できます。
• メール取得：IDを指定して特定のメールの詳細を取得できます。
• スレッド取得：メールスレッド（会話チェーン）を取得できます。
• メールマーク：メールを既読/未読、フラグ付き/フラグなしにマークできます。
• メール移動：メールをメールボックス間で移動できます。
• メール削除：メールを永久に削除できます。

メールボックス管理

• メールボックス取得：階層構造をサポートしたすべてのメールボックス/フォルダーの一覧を取得できます。

メール作成

• メール送信：プレーンテキストとHTMLをサポートした新しいメールを作成して送信できます。
• メール返信：すべての受信者に返信する機能をサポートした、既存のメールに返信できます。

主要機能

• jmap - jamを通じて完全なJMAP RFC 8620/8621準拠
• Zodスキーマによる包括的な入力検証
• すべてのリスト操作にページネーションサポート
• 豊富なエラーハンドリングと接続管理
• 全体に関数型プログラミングパターンを採用
• 強力な型付けを持つTypeScriptサポート

📦 インストール

前提条件

• Deno v1.40 以上
• JMAP対応のメールサーバー（例：Cyrus IMAP、Stalwart Mail Server、FastMail）
• 有効なJMAP認証資格情報

セットアップ

選択したエージェントに以下を追加してください。

{
  "mcpServers": {
    "fastmail": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.1.1"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "API_TOKEN"
      }
    }
  }
}

💻 使用例

環境変数

利用可能なツール

search_emails

様々なフィルターでメールを検索します。

パラメーター:

• query (オプション): テキスト検索クエリ
• from (オプション): 送信者のメールアドレスでフィルター
• to (オプション): 受信者のメールアドレスでフィルター
• subject (オプション): 件名のテキストでフィルター
• inMailbox (オプション): 特定のメールボックス内で検索
• hasKeyword (オプション): キーワードでフィルター（例：'$seen', '$flagged'）
• notKeyword (オプション): キーワードを除外
• before (オプション): 指定日付より前のメールのみ（ISO日時）
• after (オプション): 指定日付より後のメールのみ（ISO日時）
• limit (オプション): 最大結果数（1 - 100、デフォルト: 50）
• position (オプション): ページネーションの開始位置（デフォルト: 0）

get_emails

IDで特定のメールを取得します。

パラメーター:

• ids: メールIDの配列（1 - 50個のID）
• properties (オプション): 返す特定のプロパティ

get_mailboxes

メールボックス/フォルダーの一覧を取得します。

パラメーター:

• parentId (オプション): 親メールボックスでフィルター
• limit (オプション): 最大結果数（1 - 200、デフォルト: 100）
• position (オプション): ページネーションの開始位置

get_threads

IDでメールスレッドを取得します。

パラメーター:

• ids: スレッドIDの配列（1 - 20個のID）

mark_emails

キーワードでメールをマークします（既読/未読、フラグ付き/フラグなし）。

パラメーター:

• ids: メールIDの配列（1 - 100個のID）
• seen (オプション): 既読（true）または未読（false）にマーク
• flagged (オプション): フラグ付き（true）またはフラグなし（false）にマーク

move_emails

メールを別のメールボックスに移動します。

パラメーター:

• ids: メールIDの配列（1 - 100個のID）
• mailboxId: 移動先のメールボックスID

delete_emails

メールを永久に削除します。

パラメーター:

• ids: メールIDの配列（1 - 100個のID）

send_email

新しいメールを送信します。

パラメーター:

• to: name と email を持つ受信者の配列
• cc (オプション): CC受信者の配列
• bcc (オプション): BCC受信者の配列
• subject: メールの件名
• textBody (オプション): プレーンテキストの本文
• htmlBody (オプション): HTML本文
• identityId (オプション): 送信元のID

reply_to_email

既存のメールに返信します。

パラメーター:

• emailId: 返信するメールのID
• replyAll (オプション): すべての受信者に返信する（デフォルト: false）
• subject (オプション): カスタムの返信件名
• textBody (オプション): プレーンテキストの本文
• htmlBody (オプション): HTML本文
• identityId (オプション): 送信元のID

📚 ドキュメント

JMAPサーバー互換性

このサーバーは、以下を含むすべてのJMAP対応メールサーバーで動作するはずです。

• Cyrus IMAP 3.0以上
• Stalwart Mail Server
• FastMail（商用）
• Apache James（JMAPサポート付き）

開発

開発環境での実行

deno run --allow-env --allow-net --watch src/mod.ts

テスト

# 接続テスト
deno run --allow-env --allow-net src/mod.ts

アーキテクチャ

このサーバーは以下を使用して構築されています。

• Deno: 最新のJavaScript/TypeScriptランタイム
• @modelcontextprotocol/sdk: MCPサーバーフレームワーク
• [jmap - jam](https://jsr.io/@htunnicliff/jmap - jam): 軽量で型付けされたJMAPクライアント
• Zod: ランタイム型検証

セキュリティ

• すべての入力はZodスキーマを使用して検証されます。
• 環境変数は機密設定に使用されます。
• シークレットはログに記録されたり、レスポンスで公開されたりすることはありません。
• JMAPセキュリティのベストプラクティスに従っています。

コントリビュート方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 関数型プログラミングスタイルに従って変更を加えます。
4. 変更を十分にテストします。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

関連プロジェクト

• [jmap - jam](https://github.com/htunnicliff/jmap - jam) - JMAPクライアントライブラリ
• Model Context Protocol - MCP仕様
• JMAP RFC 8620 - JMAPコアプロトコル
• JMAP RFC 8621 - メール用JMAP