Pinthepiece

🚀 PinThePiece MCP 服務器

PinThePiece MCP 服務器是一個穩健的模型上下文協議（MCP）服務器，它提供了功能豐富的筆記管理系統。該服務器實現了先進的筆記存儲解決方案，注重數據的完整性、組織性和易訪問性。其主要功能包括分層存儲、原子操作、版本控制支持、自動備份以及全面的搜索功能。

🚀 快速開始

安裝

蘋果電腦（MacOS）

在 MacOS 上，配置文件路徑為：~/Library/Application\ Support/Claude/claude_desktop_config.json。 在 Windows 上，配置文件路徑為：%APPDATA%/Claude/claude_desktop_config.json%。

✨ 主要特性

筆記存儲系統

服務器實現了先進的筆記存儲系統，具備以下特性：

• 分層存儲結構，可提高組織性和擴展性。
• 原子文件操作，確保數據完整性。
• 支持版本控制和元數據。
• 自動備份功能。
• 能夠處理併發訪問。
• 全面的日誌記錄。

存儲結構

~/.pinthepiece/
├── notes/
│   ├── data/
│   │   └── YEAR/
│   │       └── MONTH/
│   │           └── note-name.json
│   ├── backups/
│   │   └── note-name.json.TIMESTAMP.bak
│   └── index.json
└── logs/
    └── notes.log

筆記格式

每個筆記存儲為一個 JSON 文件，包含以下內容：

• 內容：筆記的主要文本內容。
• 創建/修改時間戳。
• 分類標籤。
• 可選描述。
• 元數據，包括：
  • 格式版本。
  • 最後備份時間戳。
  • 內容校驗和。

資源

服務器實現的筆記存儲系統具有以下特點：

• 自定義 note:// URI 方案，用於訪問單個筆記。
• 每個筆記資源包含：
  • 名稱：唯一標識符。
  • 內容：主要文本內容。
  • 描述：可選描述。
  • 標籤：分類標籤列表。
  • 元數據：版本和完整性信息。
  • MIME 類型：text/plain。

數據安全功能

• 原子操作：所有文件寫入均使用原子操作，防止數據損壞。
• 備份系統：自動備份，方便在修改前進行參考。
• 版本控制：對文件格式進行版本控制，確保未來兼容性。
• 數據驗證：通過校驗和驗證和完整性檢查來保證數據質量。
• 併發訪問：採用文件鎖定機制，保證線程安全。
• 錯誤恢復：類似事務的操作，帶有回滾功能。

提示語句

服務器提供了一個單一的提示：

• summarize-notes：創建所有存儲筆記的摘要。
  • 可選 "style" 參數來控制詳細程度（簡潔/詳細）。
  • 根據風格偏好生成包含所有當前筆記內容的提示。

工具

服務器實現了一個工具：

• add-note：向服務器添加新的筆記。
  • 接受 "name" 和 "content" 作為必需字符串參數。
  • 可選 "tags" 和 "description" 參數。
  • 更新服務器狀態並通知客戶端資源更改。
  • 執行原子文件操作並創建備份。

📚 詳細文檔

配置

存儲位置

默認情況下，服務器將筆記存儲在以下位置：

• ~/.pinthepiece/notes/ - 主存儲目錄。
• ~/.pinthepiece/logs/ - 日誌文件目錄。

日誌記錄

• 詳細記錄所有操作的日誌。
• 採用日誌輪轉機制來管理空間。
• 提供文件和控制檯日誌輸出。
• 可配置日誌級別。

錯誤處理

服務器實現了全面的錯誤處理機制：

• 詳細的錯誤日誌，帶有堆棧跟蹤。
• 自動清理臨時文件。
• 具備中斷操作恢復功能。
• 擁有備份還原能力。
• 在加載/保存時進行數據驗證。