Win 10 MCP Server Simple Persistant Logging

🚀 Windows 10環境下MCP服務器的日誌持久化解決方案

本項目聚焦於解決Windows 10環境下MCP服務器使用時出現的問題。在使用MCP服務器時，Claude可能出現“偷懶”情況，即不完全寫入文件，致使中間過程文件被覆蓋且無法恢復。本方案通過一系列步驟實現日誌持久化，有效解決該問題。

🚀 快速開始

第一步：創建日誌記錄功能

為確保每次操作都能記錄到硬盤，創建一個新的logger.mjs文件。此腳本會自動創建logs目錄，並將所有日誌信息追加到KAN_server.log文件中。

代碼解釋：

• 使用fs.promises模塊處理異步文件操作。
• 確保logs目錄存在，避免路徑錯誤。
• 定義日誌文件，用appendFile方法將內容追加到該文件。

第二步：修改index.js中的write_file邏輯

在index.js文件裡，修改write_file操作的處理邏輯，實現以下功能：

1. 路徑驗證：確保傳入的文件路徑合法。
2. 文件備份：寫入新內容前，檢查現有文件是否存在，生成含日期時間的備份文件名。
3. 日誌記錄：將所有關鍵操作記錄到日誌文件。

修改後的邏輯流程：

1. 解析傳入參數，確保符合要求。
2. 驗證目標文件路徑是否合法。
3. 檢查文件是否存在：
   • 若存在，生成含日期時間的備份文件名，並重命名原文件。
   • 若不存在，直接寫入新內容。
4. 寫入新內容後，將成功或失敗信息記錄到日誌文件。

✨ 主要特性

• 日誌持久化：通過創建日誌記錄功能，確保每次操作都能記錄到硬盤，避免中間過程文件被覆蓋。
• 文件備份：在寫入新內容前對現有文件進行備份，保證數據的可恢復性。
• JSON響應：返回給Claude桌面應用的內容為JSON格式，確保信息能正確顯示。

💻 使用示例

基礎用法

以下是logger.mjs文件的示例代碼：

// 使用fs.promises模塊處理異步文件操作
import { promises as fs } from 'fs';
import path from 'path';

// 確保logs目錄存在
const logsDir = path.join(process.cwd(), 'logs');
await fs.mkdir(logsDir, { recursive: true });

// 定義日誌文件
const logFile = path.join(logsDir, 'KAN_server.log');

// 追加日誌信息到文件
async function logMessage(message) {
    try {
        await fs.appendFile(logFile, `${new Date().toISOString()} - ${message}\n`);
    } catch (error) {
        console.error('Error writing to log file:', error);
    }
}

// 導出日誌記錄函數
export { logMessage };

高級用法

以下是index.js中修改後的write_file邏輯示例：

// 解析傳入參數
const { filePath, content } = parseArgs(args);

// 驗證目標文件路徑
if (!isValidPath(filePath)) {
    logMessage(`Invalid file path: ${filePath}`);
    return { status: 'error', message: 'Invalid file path' };
}

// 檢查文件是否存在
const fileExists = await fs.access(filePath).then(() => true).catch(() => false);
if (fileExists) {
    // 生成備份文件名
    const backupFileName = generateBackupFileName();
    const backupFilePath = path.join(path.dirname(filePath), backupFileName);

    // 重命名原文件
    await fs.rename(filePath, backupFilePath);
    logMessage(`File backed up to: ${backupFilePath}`);
}

// 寫入新內容
try {
    await fs.writeFile(filePath, content);
    logMessage(`File written successfully: ${filePath}`);
    return { status: 'success', message: 'File written successfully', backupFile: backupFileName || null };
} catch (error) {
    logMessage(`Error writing file: ${filePath}, ${error.message}`);
    return { status: 'error', message: 'Error writing file' };
}

🔧 技術細節

備份文件名的生成規則

為確保備份文件名唯一且易於識別，採用以下格式：

[月份][日期][年份最後兩位]_[小時][分鐘]__CLDBak

例如：032524_14_59__CLDBak

返回給Claude桌面應用的響應

返回的內容必須是JSON格式，以確保Claude桌面應用能正確顯示信息。修改後的代碼確保了這一點，並在響應文本中包含了備份文件的信息。

示例響應：

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

📄 許可證

文檔未提及相關許可證信息。

⚠️ 重要提示

• 確保目標目錄有寫入權限，避免因權限問題導致操作失敗。
• 注意異常處理，在所有關鍵步驟中添加了錯誤捕捉和日誌記錄，以便及時發現和解決問題。
• 正確處理相對路徑和絕對路徑的情況，確保文件操作的準確性。

💡 使用建議

考慮到未來可能需要使用語音模式操作Windows 10，代碼中添加了詳細的註釋，方便後續維護。在進行代碼修改或擴展時，可參考這些註釋。