📝 MCP Notes
2024.12.26
21
TypeScript笔记管理AI 辅助任务管理交流协作开发效率
MCP Notes Server 是一个基于 MCP 协议的简单笔记应用，旨在帮助用户记录和查看复杂的笔记和任务，同时利用 AI 模型（如记录个人想法、笔记、灵感和见解）。它不依赖于创建项目文件，允许用户在不公开内容的情况下记录任何信息。该项目包含两个服务器：一个使用 Model Context Protocol (MCP) 的 Node.js 服务器用于 AI 驱动的笔记管理，以及一个提供用户友好界面的 Web 服务器。
View on GitHub
Overview
✨ 产品定位
MCP Notes Server 是一个基于 MCP 协议的笔记应用，旨在帮助用户记录和查看复杂的笔记和任务，同时利用 AI 模型（如记录个人想法、笔记、灵感和见解）。
🎯 核心功能
- 🖥️ 双服务器架构：MCP 服务器用于 AI 驱动的笔记管理，Web 服务器提供用户界面
- 🤖 AI 驱动的笔记记录：通过 AI 交互记录想法、见解和任务
- 🗂️ 全面的笔记管理：通过 AI 或 Web 界面创建、列出、检索、更新和删除笔记
- 📋 可靠的存储：使用 AWS DynamoDB 进行安全高效的笔记存储
- 🔐 灵活的认证：支持通过连接字符串或环境变量使用 AWS 凭证
- 📝 项目独立性：存储个人笔记而不影响项目文件或结构
🤖 适用场景
- 个人笔记记录
- 任务管理
- 灵感记录
- AI 辅助的笔记整理
🛠️ 工具列表
listNotes
- 能力：列出所有笔记，可选按标签过滤
getNote
- 能力：根据 ID 获取单个笔记
writeNote
- 能力：创建或更新笔记
deleteNote
- 能力：删除笔记
🔧 常见问题解答
-
Q: 是否需要 AWS 账户？ A: 是的，需要使用 DynamoDB 进行存储，AWS 提供免费层。
-
Q: 支持哪些 AI 模型？ A: 支持 Claude 3.5、Gemini 1.5/2.0、GPT-4、Mistral Large、Grok-2、DeepSeek Chat 等。
🛠️ 使用教程
使用依赖
- 确保已安装 Node.js
- 需要 AWS 账户以使用 DynamoDB
安装教程
推荐方式
直接使用 npx 或 bunx 运行：
npx -p mcp-notes mcp-notes-server --dynamodb "dynamodb://access_key:secret_key@region/table"
替代方式
- 克隆仓库并安装依赖：
git clone <repo-url>
cd mcp-notes
npm install
调试方式
- 启动 Web 服务器：
npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"
- 访问
http://localhost:3100查看笔记
⚙️ 凭证配置
连接字符串
dynamodb://<access_key>:<secret_key>@<region>/<table>
环境变量
- 导出
AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY - 使用不带凭证的 URI：
dynamodb://us-east-1/mcp-notes