Toast MCP Server

🚀 Windows 10 と macOS で通知機能付きの MCP サーバー

このプロジェクトは、デスクトップ通知を表示できる Model Context Protocol (MCP) サーバーを作成することを目的としています。Windows 10 では win10toast ライブラリを、macOS では osascript を使用して通知を表示します。このサーバーは、MCP クライアント（例：VSCode Cline）からのリクエストを受け取り、それに基づいてデスクトップに通知を表示します。

🚀 クイックスタート

完成したサーバーは以下のように実行できます。

python mcp_server.py --port 8000 --host 0.0.0.0

その後、VSCode Cline や他の MCP クライアントを通じて MCP プロトコルで通知をトリガーできます。

✨ 主な機能

機能要件

1. MCP プロトコルサポート
   • MCP クライアントとの通信を実装し、Model Context Protocol を確立します。
   • 最新の MCP 仕様をサポートし（VSCode Cline との完全な互換性を提供します）、同期および非同期リクエストを処理します。
2. 通知システム
   • Windows 10 では win10toast ライブラリを使用してデスクトップ通知を表示します。
   • macOS では osascript を使用して NotificationCenter に通知を表示します。
   • カスタマイズ可能な通知パラメータをサポートします。
     • タイトル
     • メッセージ内容
     • 表示時間
     • アイコン（Windows 専用、オプション）
     • サブタイトル（macOS 専用、オプション）
     • 通知音（macOS 専用、オプション）
     • 通知タイプ（情報、警告、エラー、成功）
3. クライアント接続
   • 設定されたネットワークインターフェイスでのリスニングをサポートします（localhost の 127.0.0.1 だけでなく、すべてのインターフェイスの 0.0.0.0 もサポート）。
   • ポートの設定をサポートします（デフォルト：8000）。
   • 複数の同時クライアント接続を処理し、接続問題に対して適切なエラー処理を行います。
4. コマンド処理
   • MCP クライアントからの通知コマンドを処理し、通知をトリガーする簡単な API をサポートします。
   • コマンドの検証を行い、適切なエラー応答を提供します。

技術要件

1. サーバー実装
   • Python 3.8 以上を使用して実装し、asyncio または同様のライブラリを使用して非同期サーバーを実現します。
   • MCP サーバー実装のベストプラクティスに従います。
2. 依存関係
   • Windows 10 のデスクトップ通知用の win10toast。
   • macOS 通知用の osascript（システム標準）。
   • MCP プロトコルを実装するためのライブラリ。
   • 外部依存関係を最小限に抑えます。
3. 設定
   • コマンドライン引数による設定をサポートします。
   • 環境変数による設定をサポートします。
   • すべての設定に合理的なデフォルト値を提供します。
4. ログ記録とエラー処理
   • 包括的なログシステムを実装し、すべてのクライアント接続、コマンド、エラーを記録します。
   • 意味のあるエラーメッセージを持つ適切な例外処理を行います。

テスト要件

1. テストスクリプト
   • サーバー機能を検証するテストスクリプトを含み、さまざまな通知タイプの例を示します。
2. クライアント相互運用性
   • VSCode Cline との相互運用性を確保し、クライアント固有の設定要件を文書化します。

📦 成果物

1. Python で実装された MCP サーバー
2. 機能を検証するテストスクリプト
3. すべての依存関係を列挙した requirements.txt
4. 使用方法と設定に関するドキュメント
5. 一般的な問題のトラブルシューティングガイド

🔧 実装注意事項

• サーバーを localhost 以外のすべてのインターフェイス（0.0.0.0）にバインドします。
• 同時リクエストを処理するために適切なスレッドまたは非同期モードを使用します。
• 適切な入力検証などのセキュリティ対策を含めます。
• 接続問題のデバッグのために詳細なログオプションを提供します。
• サーバーの適切なシャットダウンを実装します。

💻 使用例

基本的な使用法

# 完成したサーバーの実行コマンド
python mcp_server.py --port 8000 --host 0.0.0.0

その後、VSCode Cline や他の MCP クライアントを通じて MCP プロトコルで通知をトリガーできます。