Skip to main content
Glama

📝 MCP 注释

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 聊天


🛠️ 安装

受到推崇的

直接使用npxbunx运行,请参阅下面的示例。

选择

  1. 确保您的系统上安装了Node.js。

  2. 克隆此存储库并使用以下命令安装依赖项: npm install

  3. 配置 Claude Desktop 或任何其他工具,如下所示


⚙️ 凭证配置

连接字符串

dynamodb://<access_key>:<secret_key>@<region>/<table>

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

环境变量

  1. 导出AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY

  2. 在 URI 中提供不带凭证的连接信息: dynamodb://us-east-1/mcp-notes


🤖 与工具集成

克劳德桌面

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

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

或本地磁盘上的文件:

{ "mcpServers": { "mcp-notes": { "command": "node", "args": [ "file://path/to/notes-mcp-server.js", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

科迪

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

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

{ "openctx.providers": { "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": { "nodeCommand": "node", "mcp.provider.uri": "file://path/to/notes-mcp-server.js", "mcp.provider.args": [ "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

或者,与npx一起使用(不保证有效):

{ "openctx.providers": { "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": { "nodeCommand": "node", "mcp.provider.uri": "file:///usr/local/bin/npx", "mcp.provider.args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

克莱恩

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

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

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

🚀 运行 Web 服务器

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

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

或者,使用npm run build进行编译并运行node dist/notes-mcp-server.jsnode 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 :笔记的主要内容。


📸 截图

克劳德桌面

✅ 功能齐全

Claude Desktop 中 MCP Notes 工具调用截图Claude Desktop 中的 MCP Notes 资源截图

科迪

✅ 通过资源提及注释

❎ 不支持工具调用

Cody 中的 MCP Notes 截图

克莱恩

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

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

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/9Ninety/MCPNotes'

If you have feedback or need assistance with the MCP directory API, please join our Discord server