📝 MCP Notes

简介

MCP 笔记是一个基于 MCP 协议的笔记应用，允许您结合 AI 模型能力管理个人笔记和任务。它使用 DynamoDB 存储数据，包含 MCP 服务器和 Web 界面两个组件。

前提条件

• Node.js 环境
• AWS 账户（DynamoDB 使用）
• 支持 MCP 的 AI 客户端（如 Claude Desktop、Cline 等）

快速安装

直接使用 npx 或 bunx 运行:

npx -p mcp-notes mcp-notes-server --dynamodb "dynamodb://access_key:secret_key@region/table"

配置凭证

选项 1: 连接字符串

dynamodb://access_key:secret_key@region/table

选项 2: 环境变量

1. 设置 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY
2. 使用简化连接字符串: dynamodb://region/table

客户端集成

Claude Desktop

编辑 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"
      ]
    }
  }
}

Cline

编辑 cline_mcp_settings.json:

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

运行 Web 界面

启动 Web 服务器以在浏览器中管理笔记:

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

然后访问 http://localhost:3100

MCP 工具功能

• listNotes: 列出所有笔记，可按标签过滤
• getNote: 获取单个笔记
• writeNote: 创建或更新笔记
• deleteNote: 删除笔记

数据结构

笔记包含以下字段:

• id: 唯一标识符
• title: 标题
• summary: 简短摘要
• tags: 标签数组
• content: 笔记内容

支持的 AI 模型

可与任何支持函数调用的 MCP 客户端一起使用，包括:

• Claude 3.5 系列
• Gemini 1.5/2.0 系列
• GPT-4 系列
• Mistral Large
• Grok-2
• DeepSeek Chat