📝 MCP Notes - MCP服务，MCP服务器，MCP教程

✨ 产品定位

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 等。

🛠️ 使用教程

使用依赖

1. 确保已安装 Node.js
2. 需要 AWS 账户以使用 DynamoDB

安装教程

推荐方式

直接使用 npx 或 bunx 运行：
bash
npx -p mcp-notes mcp-notes-server --dynamodb "dynamodb://access_key:secret_key@region/table"

替代方式

1. 克隆仓库并安装依赖：
   bash
git clone <repo-url>
cd mcp-notes
npm install

调试方式

1. 启动 Web 服务器：
   bash
npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"
2. 访问 http://localhost:3100 查看笔记

⚙️ 凭证配置

连接字符串

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

环境变量

1. 导出 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY
2. 使用不带凭证的 URI：dynamodb://us-east-1/mcp-notes