Mcpnotes

🚀 MCP 筆記服務器

MCP 筆記服務器是一款強大的筆記管理工具，藉助模型上下文協議（Model Context Protocol），為用戶提供便捷的筆記創建、讀取、更新和刪除操作，極大提升筆記管理效率。

🚀 快速開始

MCP 筆記服務器使用模型上下文協議（Model Context Protocol）提供服務，可幫助用戶輕鬆管理筆記。以下是啟動服務器的步驟：

安裝 MCP 筆記服務器

npm install -p mcp-notes

運行 Web 服務器

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"

啟動後，打開瀏覽器訪問 http://localhost:3100 即可使用。

憑證配置

在運行時，你可以通過以下兩種方式指定 AWS 憑證： 方式一：使用 AWS 配置文件

AWS_PROFILE=your-profile-name npm run start

方式二：直接傳遞憑證

--dynamodb "dynamodb://access_key:secret_key@region/table"

✨ 主要特性

• 列出筆記：可根據可選標籤過濾所有筆記，快速定位所需內容。
• 獲取筆記：依據筆記 ID 精準獲取單個筆記。
• 寫入筆記：能創建或更新帶有唯一 ID 的新筆記。
• 刪除筆記：通過 ID 輕鬆刪除指定的筆記。

📦 安裝指南

安裝 MCP 筆記服務器

npm install -p mcp-notes

運行 Web 服務器

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"

啟動服務器後，在瀏覽器中訪問 http://localhost:3100 開啟筆記管理之旅。

💻 使用示例

基礎用法

listNotes

// 輸入
{ tags: ["會議"] }
// 輸出：返回所有標籤包含 "會議" 的筆記

getNote

// 輸入
{ id: "meeting-notes-1362" }
// 輸出：返回 ID 為 "meeting-notes-1362" 的筆記，若未找到則給出提示

writeNote

// 輸入
{ 
  id: "new-note-001", 
  title: "新項目討論", 
  summary: "討論新項目的初步規劃", 
  tags: ["項目", "討論"], 
  content: "本次會議探討了新項目的目標和初步計劃..." 
}
// 輸出：成功確認消息

deleteNote

// 輸入
{ id: "old-note-002" }
// 輸出：刪除確認消息

📚 詳細文檔

MCP 工具

listNotes

• 輸入：{ tags?: string[] }
• 輸出：返回所有筆記，可按標籤過濾。

getNote

• 輸入：{ id: string }
• 輸出：根據 ID 返回單個筆記或提示未找到。

writeNote

• 輸入：{ id: string, title: string, summary: string, tags: string[], content: string }
• 輸出：成功確認消息。

deleteNote

• 輸入：{ id: string }
• 輸出：刪除確認消息。

數據結構

筆記存儲結構如下：

模型支持

MCP 筆記服務器與以下工具集成：

• Claude Desktop：功能完整，支持工具調用和資源訪問。
• Cody：支持提及資源，但不支持工具調用。
• Cline：支持工具調用，資源功能待驗證。

屏幕快照

Claude Desktop

• 功能完整：支持工具調用和資源訪問。

Cody

• 提及資源：不支持工具調用。

Cline

• 工具調用支持：資源功能待驗證。