📝 MCP 注释

✨ 概述
MCP Notes Server是一款基于 MCP 协议构建的简易笔记应用。其目标是帮助用户记录和查看复杂的笔记和任务,同时利用 AI 模型,例如记录个人想法、笔记、灵感和见解。它无需创建项目文件,用户可以记录任何内容,而无需在项目内部公开。
该项目包括两个服务器:一个使用模型上下文协议 (MCP) 进行 AI 驱动的笔记管理的 Node.js 服务器,以及一个提供用户友好界面以便与笔记进行手动交互的 Web 服务器。
**注意:**本项目需要使用 DynamoDB 来存储笔记。您需要一个 AWS 账户才能使用它。AWS 为 DynamoDB 提供了慷慨的免费套餐,非常适合个人频繁使用且无需支付任何费用。
Related MCP server: Beeper MCP Note Server
🎯 核心功能
🖥️**双服务器架构:**用于 AI 驱动的笔记管理的 MCP 服务器和用于用户界面的 Web 服务器
🤖**人工智能笔记:**通过人工智能互动记录想法、见解和任务
🗂️**全面的笔记管理:**通过 AI 或 Web 界面创建、列出、检索、更新和删除笔记
📋**可靠的存储:**使用 AWS DynamoDB 进行安全高效的笔记存储
🔐**灵活的身份验证:**通过连接字符串或环境变量支持 AWS 凭证
📝**独立于项目:**存储个人笔记而不影响项目文件或结构
🤖 模型支持
只要您的客户端支持 MCP,您就可以使用任何支持函数调用的模型。以下模型已测试并确认可以正常工作:
克劳德3.5系列
双子座 1.5 和 2.0 系列
GPT-4 系列
米斯特拉尔大号
Grok-2
DeepSeek 聊天
🛠️ 安装
受到推崇的
直接使用npx或bunx运行,请参阅下面的示例。
选择
确保您的系统上安装了Node.js。
克隆此存储库并使用以下命令安装依赖项:
npm install配置 Claude Desktop 或任何其他工具,如下所示
⚙️ 凭证配置
连接字符串
例如:
dynamodb://AKIAXXXXXXXX:SKXXXXXXXX@us-east-1/mcp-notes
环境变量
导出
AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。在 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:笔记的主要内容。
📸 截图
克劳德桌面
✅ 功能齐全


科迪
✅ 通过资源提及注释
❎ 不支持工具调用

克莱恩
✅ 具有工具调用的完整功能
❓ 资源似乎不起作用;需要帮助。