📝 MCP 笔记

✨ 概述

MCP 笔记服务器 是一个基于 MCP 协议构建的简单笔记应用程序。它的目的是使用户能够记录和查看复杂的笔记和任务，同时利用 AI 模型，例如记录个人想法、笔记、灵感和见解。它不依赖于创建项目文件，允许用户记录任何内容，而无需在项目中公开。

该项目包括两个服务器：一个使用模型上下文协议 (MCP) 的 Node.js 服务器，用于 AI 驱动的笔记管理，以及一个 Web 服务器，提供用户友好的界面，用于手动与您的笔记进行交互。

注意： 此项目需要 DynamoDB 用于笔记存储。您需要一个 AWS 账户才能使用它。AWS 为 DynamoDB 提供了慷慨的免费套餐，使其适合频繁的个人使用，且无需任何费用。

---

🎯 核心功能

• 🖥️ 双服务器架构： MCP 服务器用于 AI 驱动的笔记管理，Web 服务器用于用户界面
• 🤖 AI 驱动的笔记： 通过 AI 交互记录想法、见解和任务
• 🗂️ 全面的笔记管理： 通过 AI 或 Web 界面创建、列出、检索、更新和删除笔记
• 📋 可靠的存储： 使用 AWS DynamoDB 安全高效地存储笔记
• 🔐 灵活的身份验证： 支持通过连接字符串或环境变量进行 AWS 凭证验证
• 📝 项目独立： 存储个人笔记，而不会影响项目文件或结构

---

🤖 模型支持

您可以使用任何支持函数调用的模型，只要您的客户端支持 MCP 即可。以下模型已经过测试并确认可以工作：

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

---

🛠️ 安装

推荐

直接使用 npx 或 bunx 运行，请参见以下示例。

替代方案

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_ID 和 AWS_SECRET_ACCESS_KEY。
2. 在 URI 中提供不带凭证的连接信息：dynamodb://us-east-1/mcp-notes

---

🤖 与工具集成

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

或本地磁盘上的文件：

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

Cody

注意： 目前，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

将此代码段添加到 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.js 或 node dist/notes-web-server.js

然后在您的浏览器中导航到 http://localhost:3100 以查看笔记。

---

🔧 可用的 MCP 工具

listNotes

• 输入： { tags?: string[] }
• 输出： 所有笔记的数组，可以选择按标签过滤。

getNote

• 输入： { id: string }
• 输出： 与给定 ID 匹配的单个笔记对象；如果不存在匹配项，则返回“未找到”消息。

writeNote

• 输入： { id: string, title: string, summary: string, tags: string[], content: string }
• 输出： 成功确认消息。

deleteNote

• 输入： { id: string }
• 输出： 删除确认消息 🚮。

---

📝 数据结构

笔记使用以下结构存储：

• id: 笔记的唯一标识符。它应该是描述性的，带有随机数字后缀，例如“meeting-notes-1362”。
• title: 笔记的标题。
• summary: 笔记内容的简短摘要。
• tags: 与笔记关联的标签数组（例如，["meeting", "project-x"]）。
• content: 笔记的主要内容。

---

📸 屏幕截图

Claude Desktop

✅ 功能齐全

Cody

✅ 通过资源提及笔记

❎ 不支持工具调用

Cline

✅ 功能齐全，支持工具调用

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

<img src="./assets/screenshot-cline-tool-calling.png" alt="Cline 中 MCP 笔记的屏幕截图" style="max-height: 1200px;">