MCP Notes

MCP Notes 是一款基于模型上下文协议（MCP）的智能笔记工具，支持通过 AI 聊天工具或网页界面进行笔记的创建、读取、更新和删除操作。它将笔记存储在 AWS DynamoDB 中，确保数据安全且易于管理，适用于各类用户高效整理信息。

核心功能

MCP Notes 提供了以下核心功能，帮助用户高效管理笔记：

• 列出笔记：支持根据标签过滤所有笔记，便于快速查找。
• 获取笔记：通过唯一 ID 精准获取单个笔记。
• 写入笔记：创建或更新带有唯一 ID 的新笔记，支持标题、摘要、标签和内容的完整结构。
• 删除笔记：通过 ID 删除指定笔记。

此外，MCP Notes 支持与多种 AI 工具集成，如 Claude Desktop、Cody 和 Cline，实现工具调用和资源访问，提升笔记管理的智能化水平。

安装方法

安装 MCP Notes 需要使用 npm 包管理器。以下是安装和运行服务器的步骤：

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"

使用方法

MCP Notes 提供了多种 API 接口，支持通过 JSON 格式进行交互。以下是几个常用操作的示例：

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 Notes 适用于多种使用场景，包括但不限于：

• 记录灵感、创意和想法
• 整理会议要点和讨论内容
• 进行个人反思和学习笔记
• 管理项目计划和任务

无论是专业人士还是学生，都可以通过 MCP Notes 提升笔记管理的效率和智能化水平。

数据结构

每条笔记的结构如下：

工具集成

MCP Notes 与多种 AI 工具集成，包括：

• Claude Desktop：功能完整，支持工具调用和资源访问。
• Cody：支持提及资源，但不支持工具调用。
• Cline：支持工具调用，资源功能待验证。

注意事项

在使用 MCP Notes 时，需注意以下事项：

• 笔记存储在 AWS DynamoDB 中，需确保 AWS 凭证配置正确。
• 建议使用描述性 ID 以方便后续查找。
• AI 工具的集成程度可能因工具版本不同而有所差异。

MCP Notes 为用户提供了灵活、智能的笔记管理方式，结合 AI 和云端存储，是记录和整理信息的理想选择。