Temp Notes MCP Server

🚀 溫度筆記使用說明

Temp Notes 是一款輔助工具，可在多步驟或多會話任務中保存和恢復上下文，尤其適用於需跨多個對話完成複雜任務的場景。

🚀 快速開始

Temp Notes 操作簡單，能快速上手。下面為你介紹基本使用步驟：

1. 初始化：

   // 初始化新筆記
   mcp_temp_note init
   

2. 寫入內容：

   // 寫入新的文本內容
   mcp_temp_note write "你的筆記內容"
   

3. 讀取內容：

   // 讀取當前筆記內容
   mcp_temp_note read
   

4. 清除內容：

   // 清除當前筆記內容
   mcp_temp_note clear
   

✨ 主要特性

• 持久化存儲：筆記內容會在本地文件中長期保存，直到被明確清除。
• 獨立會話：每個新對話都會創建一個新的空白筆記本，防止數據混雜。
• 文件路徑：
  • macOS/Linux 系統：~/.mcp_config/temp_notes.txt（實際路徑為 /Users/username/.mcp_config/temp_notes.txt）
  • Windows 系統：C:\Users\username\.mcp_config\temp_notes.txt

📦 安裝指南

如果你想使用 Temp Notes 的命令行接口（CLI）工具，可通過以下命令進行安裝：

// 安裝 CLI 工具
npm install -g mcp-temp-note-cli

💻 使用示例

基礎用法

作為任務檢查清單

// 存儲任務清單
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "write_note",
  arguments: {
    content: "# 項目重構待辦事項\n\n- [ ] 分析當前架構\n- [ ] 確定性能瓶頸\n- [ ] 創建新組件結構\n- [ ] 實現數據層更改\n- [ ] 更新 UI 組件\n- [ ] 編寫測試用例\n- [ ] 更新文檔"
  }
});

高級用法

恢復存儲信息

// 在新的對話中恢復清單
const result = await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "read_note",
  arguments: {}
});

// 結果包含之前存儲的清單內容

更新任務進度

// 更新筆記內容以反映進展
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "append_note",
  arguments: {
    content: "## 架構分析完成\n\n關鍵發現：\n- 當前結構存在循環依賴\n- 數據獲取效率低下\n- 組件複用度低\n\n建議：實現倉庫模式和組件組合",
    include_separator: true
  }
});

清除筆記內容

// 完成任務後清除筆記
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "clear_note",
  arguments: {}
});

📚 詳細文檔

使用場景

複雜編碼任務

在處理複雜編碼任務時，Temp Notes 可以幫助：

• 存儲任務清單
• 包含每個子任務的詳細描述
• 記錄需要檢查的具體文件
• 跟蹤跨多個對話的任務進度

保持上下文跨越對話

隨著對話長度增加，上下文窗口可能被填滿。Temp Notes 允許：

• 總結當前任務狀態
• 文檔已完成步驟和剩餘工作
• 存儲重要信息以便後續參考
• 記錄下一步驟以供新對話繼續

跨存儲庫信息傳輸

在處理多個存儲庫或項目時，Temp Notes 可用於：

• 存儲來自一個倉庫的代碼片段
• 保存文件內容作為參考資料
• 文檔從一個項目到另一個項目的模式或做法
• 創建臨時文檔以連接不同項目

協作工作流

多用戶協作時，Temp Notes 可幫助：

• 中央存儲任務信息
• 分散團隊成員的工作進度
• 確保所有參與者信息同步

配置說明

Temp Notes 服務器的配置信息如下：

示例配置

// 初始化 Temp Notes 服務
{
  "server_name": "temp-notes",
  "storage_path": "~/.mcp_config/",
  "encrypt_data": false
}

錯誤處理

常見錯誤及解決方案

1. 筆記文件無法打開：

   • 確保路徑權限正確
   • 檢查是否有其他進程佔用該文件

2. 加密失敗：

   • 確保加密密鑰正確無誤
   • 檢查系統是否支持所需加密算法

3. 讀取內容為空：

   • 確認寫入操作成功執行
   • 檢查是否有意外清除操作發生

安全注意事項

• 數據加密：所有存儲內容都應進行加密處理，特別是在敏感環境中。
• 訪問控制：限制對 Temp Notes 服務的訪問權限，防止未授權訪問。
• 備份策略：定期備份筆記文件，以防數據丟失。

升級指南

從舊版本升級到新版本時，請注意：

• 檢查是否有配置參數的變化
• 確保兼容性，必要時調整客戶端代碼
• 執行升級前，先進行數據備份

命令行工具參考

Temp Notes 提供了命令行接口（CLI）工具，方便用戶直接操作筆記文件。

使用示例

// 查看幫助信息
mcp_temp_note --help

// 寫入內容到筆記
mcp_temp_note write "你的筆記內容"

// 讀取當前筆記內容
mcp_temp_note read

// 清除筆記內容
mcp_temp_note clear

API 文檔

Temp Notes 提供了 RESTful API，允許開發者集成到自定義應用中。

寫入內容

POST /notes
Content-Type: text/plain

你的筆記內容

讀取內容

GET /notes

清除內容

DELETE /notes

📄 許可證

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

📞 聯繫方式

如有任何問題或反饋，請聯繫：

• 郵件：support@temp-notes.com
• GitHub：https://github.com/temp-notes

⚠️ 重要提示

使用 Temp Notes 時，請遵守相關法律法規，確保數據安全和隱私保護。