Win 10 MCP Server Simple Persistant Logging

🚀 Windows 10環境下MCPサーバーのログ永続化ソリューション

Windows 10環境下のMCP（特定のカスタムプロトコルまたはツールかもしれません）サーバーを使用する際、Claudeが「怠ける」（つまり、ファイルに完全に書き込まない）ことがあり、中間過程のファイルが上書きされて復元できなくなるという問題に直面しました。この問題を解決するため、以下の手順を実行しました。

🚀 クイックスタート

ステップ1：ログ記録機能の作成

各操作がハードディスクに記録されるように、新しいlogger.mjsファイルを作成しました。このスクリプトは自動的にlogsディレクトリを作成し、すべてのログ情報をKAN_server.logという名前のファイルに追加します。

コードの説明

• fs.promisesモジュールを使用して非同期ファイル操作を処理します。
• logsディレクトリが存在することを確認し、パスエラーを回避します。
• ログファイルを定義し、appendFileメソッドを使用して内容をそのファイルに追加します。

ステップ2：index.jsのwrite_fileロジックの修正

index.jsファイルで、write_file操作の処理ロジックを修正し、以下の機能を実現しました。

1. パス検証：渡されたファイルパスが有効であることを確認します。
2. ファイルバックアップ：新しい内容を書き込む前に、既存のファイルが存在するかどうかを確認し、日付と時刻を含むバックアップファイル名を生成します。
3. ログ記録：すべての重要な操作をログファイルに記録します。

修正後のロジックの流れ

1. 渡されたパラメータを解析し、要件を満たしていることを確認します。
2. ターゲットファイルパスが有効であることを検証します。
3. ファイルが存在するかどうかを確認します。
   • 存在する場合は、日付と時刻を含むバックアップファイル名を生成し、元のファイルをリネームします。
   • 存在しない場合は、新しい内容を直接書き込みます。
4. 新しい内容を書き込んだ後、成功または失敗の情報をログファイルに記録します。

✨ 主な機能

バックアップファイル名の生成規則

バックアップファイル名が一意で識別しやすいように、以下の形式を採用しました。

[月][日][西暦の下2桁]_[時][分]__CLDBak

例：032524_14_59__CLDBak

Claudeデスクトップアプリへの応答

Claudeデスクトップアプリが情報を正しく表示できるように、返される内容はJSON形式でなければなりません。私の修正により、これが保証され、応答テキストにバックアップファイルの情報が含まれるようになりました。

応答例

{
  "status": "success",
  "message": "File written successfully. Backup file created as 032524_14_59__CLDBak."
}

🔧 技術詳細

注意事項

• 権限問題：ターゲットディレクトリに書き込み権限があることを確認してください。
• 例外処理：すべての重要なステップにエラー捕捉とログ記録を追加し、問題をすぐに発見して解決できるようにしました。
• ファイルパスの処理：相対パスと絶対パスのケースを正しく処理します。

予想される用途

将来的にWindows 10を音声モードで操作する必要があるかもしれないことを考慮し、コードに詳細なコメントを追加し、将来の保守作業を容易にしました。