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

• 工具调用支持：资源功能待验证。