🚀 Protonmail MCP サーバー

このMCPサーバーは、amotivvによって提供され、Protonmailサービスとの統合に使用されます。Model Context Protocol（MCP）プロトコルを介して外部サービスに接続する必要があるユーザー向けに設計されています。

🚀 クイックスタート

このMCPサーバーは、Protonmailサービスとの統合を容易にするために提供されています。以下に、使用方法や機能について説明します。

✨ 主な機能

直接統合：追加の設定なしで、Protonmailサービスに直接接続できます。
安全な転送：SSL/TLSによる暗号化通信をサポートし、データ転送の安全性を確保します。
マルチスレッド対応：複数の同時リクエストを処理でき、性能と応答速度を向上させます。
ログ記録：詳細なログシステムが組み込まれており、サーバーのデバッグと監視が容易です。

📦 インストール

クイックインストール

リポジトリをクローンします：

git clone https://github.com/amotivv/protonmail-mcp.git
cd protonmail-mcp

依存関係をインストールしてビルドします：
```
npm install
npm run build
```
環境変数を設定し、Protonmail APIキーとエンドポイントを設定します。
サーバーを起動します：
```
npm start
```

拡張機能

カスタムログ：ユーザーが必要に応じてログ記録機能を拡張できます。
プラグインサポート：柔軟なプラグインシステムが提供され、追加の機能モジュールを簡単に追加できます。

📚 ドキュメント

環境変数の設定

サーバーを実行するために必要な主要な環境変数は次のとおりです：

変数名	タイプ	必須	説明
PROTONMAIL_API_KEY	String	はい	Protonmail APIアクセスキー
PROTONMAIL_ENDPOINT	String	いいえ	デフォルトはapi.proton.me
PORT	Number	いいえ	デフォルトポートは3001

ログ設定

ユーザーは出力形式とログレベルを選択でき、以下のオプションがサポートされています：

JSON形式：機械による解析に便利です。
PLAINテキスト：手動での確認に適しています。
SYSLOG形式：システムログ記録ツールと互換性があります。

💻 使用例

基本的な使用法

const { ProtonmailService } = require('protonmail-mcp');

async function sendEmail(to, subject, text) {
    const service = new ProtonmailService({
        apiKey: 'your_api_key',
        endpoint: 'api.proton.me'
    });

    await service.send({
        to,
        subject,
        text
    });
}

// サンプル呼び出し
sendEmail('user@example.com', 'テストメール', 'これはテストメールです。')
    .then(() => console.log('メール送信成功！'))
    .catch(err => console.error('送信失敗:', err));

高度な使用法

const { ProtonmailService, Logger } = require('protonmail-mcp');

// カスタムログ記録器
const logger = new Logger({
    format: 'json',
    level: 'debug'
});

async function processEmails(emails) {
    const service = new ProtonmailService({
        apiKey: process.env.PROTONMAIL_API_KEY,
        endpoint: process.env.PROTONMAIL_ENDPOINT,
        logger
    });

    for (const email of emails) {
        try {
            await service.send(email);
            logger.info(`メールが ${email.to} に送信されました`);
        } catch (error) {
            logger.error(`送信失敗：${email.to}`, error);
        }
    }
}

// サンプル呼び出し
processEmails([
    { to: 'user1@example.com', subject: '通知', text: '新しいメッセージのお知らせ' },
    { to: 'user2@example.com', subject: '更新', text: 'システムが更新されました。確認してください。' }
]);

トラブルシューティング

よくある質問と回答

接続タイムアウト：
- ネットワークが正常に接続されていることを確認してください。
- Protonmail APIエンドポイントが利用可能であることを確認してください。
- サーバーのログを確認して、詳細な情報を取得してください。
認証失敗：
- APIキーが正しいことを確認してください。
- キーが期限切れまたはロックされていないことを確認してください。
- Protonmailサポートチームに連絡して、キーの状態を確認してください。
メール送信制限：
- レート制限のドキュメントを確認してください。
- メールの送信頻度を分散させ、制限をトリガーしないようにしてください。
- 送信制限を引き上げるために、プレミアムアカウントにアップグレードしてください。