MCP Notes

📝 MCP 注释

✨ 概述

MCP Notes Server是一款基于 MCP 协议构建的简易笔记应用。其目标是帮助用户记录和查看复杂的笔记和任务，同时利用 AI 模型，例如记录个人想法、笔记、灵感和见解。它无需创建项目文件，用户可以记录任何内容，而无需在项目内部公开。

该项目包括两个服务器：一个使用模型上下文协议 (MCP) 进行 AI 驱动的笔记管理的 Node.js 服务器，以及一个提供用户友好界面以便与笔记进行手动交互的 Web 服务器。

**注意：**本项目需要使用 DynamoDB 来存储笔记。您需要一个 AWS 账户才能使用它。AWS 为 DynamoDB 提供了慷慨的免费套餐，非常适合个人频繁使用且无需支付任何费用。

🎯 核心功能

• 🖥️**双服务器架构：**用于 AI 驱动的笔记管理的 MCP 服务器和用于用户界面的 Web 服务器
• 🤖**人工智能笔记：**通过人工智能互动记录想法、见解和任务
• 🗂️**全面的笔记管理：**通过 AI 或 Web 界面创建、列出、检索、更新和删除笔记
• 📋**可靠的存储：**使用 AWS DynamoDB 进行安全高效的笔记存储
• 🔐**灵活的身份验证：**通过连接字符串或环境变量支持 AWS 凭证
• 📝**独立于项目：**存储个人笔记而不影响项目文件或结构

🤖 模型支持

只要您的客户端支持 MCP，您就可以使用任何支持函数调用的模型。以下模型已测试并确认可以正常工作：

• 克劳德3.5系列
• 双子座 1.5 和 2.0 系列
• GPT-4 系列
• 米斯特拉尔大号
• Grok-2
• DeepSeek 聊天

🛠️ 安装

受到推崇的

直接使用npx或bunx运行，请参阅下面的示例。

选择

1. 确保您的系统上安装了Node.js。
2. 克隆此存储库并使用以下命令安装依赖项： npm install
3. 配置 Claude Desktop 或任何其他工具，如下所示

⚙️ 凭证配置

连接字符串

例如： dynamodb://AKIAXXXXXXXX:SKXXXXXXXX@us-east-1/mcp-notes

环境变量

1. 导出AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY 。
2. 在 URI 中提供不带凭证的连接信息： dynamodb://us-east-1/mcp-notes

🤖 与工具集成

克劳德桌面

将此代码片段添加到claude_desktop_config.json ：

或本地磁盘上的文件：

科迪

**注意：**目前，Cody 对 MCP 服务器的支持有限。
它仅允许连接一个服务器，并且无法进行工具调用。您需要使用 Web 界面创建和管理笔记，然后在 AI 聊天对话中引用它们。

将此代码片段添加到您的 VS Code 设置中：

或者，与npx一起使用（不保证有效）：

克莱恩

将此代码片段添加到cline_mcp_settings.json ：

你会发现“新建任务”按钮旁边有一个“MCP 服务器”图标，然后有一个“编辑 MCP 设置”按钮来打开这个文件。

🚀 运行 Web 服务器

Web 服务器提供了一个用户友好的界面来管理您的笔记。您可以启动 Web 界面来管理您的笔记，为 AI 添加新笔记，或修改 AI 生成的笔记的部分内容。

或者，使用npm run build进行编译并运行node dist/notes-mcp-server.js或node dist/notes-web-server.js

然后在浏览器中导航至http://localhost:3100查看笔记。

🔧 可用的 MCP 工具

列表注释

• 输入： { tags?: string[] }
• **输出：**所有注释的数组，可选择按标签进行过滤。

获取注释

• 输入： { id: string }
• **输出：**与给定 ID 匹配的单个注释对象，如果不存在匹配，则显示“未找到”消息。

写笔记

• 输入： { id: string, title: string, summary: string, tags: string[], content: string }
• **输出：**成功确认消息。

删除注释

• 输入： { id: string }
• **输出：**删除确认消息🚮。

📝 数据结构

注释使用以下结构存储：

• id ：笔记的唯一标识符。它应该具有描述性，并带有随机数字后缀，例如“meeting-notes-1362”。
• title ：笔记的标题。
• summary ：笔记内容的简短摘要。
• tags ：与笔记相关的标签数组（例如，[“meeting”，“project-x”]）。
• content ：笔记的主要内容。

📸 截图

克劳德桌面

✅ 功能齐全

科迪

✅ 通过资源提及注释

❎ 不支持工具调用

克莱恩

✅ 具有工具调用的完整功能

❓ 资源似乎不起作用；需要帮助。