✨ 概述

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

该项目包括两台服务器：一台使用模型上下文协议（MCP）进行AI驱动笔记管理的Node.js服务器，另一台提供用户友好界面的网页服务器，方便你手动操作笔记。

注： 本项目需要DynamoDB作为笔记存储工具。你需要一个AWS账户才能使用它。AWS为DynamoDB提供了慷慨的免费套餐，适合频繁个人免费使用。

---

🎯 核心功能

• 🖥️ 双服务器架构： MCP服务器用于AI驱动的笔记管理，Web服务器用于用户界面
• 🤖 AI驱动的笔记记录： 通过AI互动记录想法、见解和任务
• 🗂️ 全面笔记管理： 通过AI或网页界面创建、列出、检索、更新和删除笔记

📝 MCP Notes

✨ Overview

MCP Notes Server is a simple note-taking application built on top of the MCP protocol. Its purpose is to enable users to record and view complex notes and tasks while utilizing AI models, such as recording personal thoughts, notes, inspirations, and insights. It does not rely on creating project files, allowing users to record any content without making it public within the project.

This project includes two servers: a Node.js server using the Model Context Protocol (MCP) for AI-driven note management and a web server providing a user-friendly interface for manual interaction with your notes.

Note: This project requires DynamoDB for note storage. You’ll need an AWS account to use it. AWS offers a generous free tier for DynamoDB, making it suitable for frequent personal use at no cost.

---

🎯 Core Features

• 🖥️ Dual Server Architecture: MCP server for AI-driven note management and Web server for the user interface
• 🤖 AI-Powered Note Taking: Record thoughts, insights, and tasks through AI interactions
• 🗂️ Comprehensive Note Management: Create, list, retrieve, update, and delete notes via AI or web interface
• 📋 Reliable Storage: Secure and efficient note storage with AWS DynamoDB
• 🔐 Flexible Authentication: Support for AWS credentials via connection strings or environment variables
• 📝 Project-Independent: Store personal notes without affecting project files or structure

---

🤖 Model Support

You can use any model that supports function calls as long as your client supports MCP. The following models have been tested and confirmed to work:

• Claude 3.5 Series
• Gemini 1.5 and 2.0 Series
• GPT-4 Series
• Mistral Large
• Grok-2
• DeepSeek Chat

---

🛠️ Installation

Recommended

Run directly with npx or bunx, see examples below.

Alternative

1. Ensure Node.js is installed on your system.
2. Clone this repository and install dependencies with: npm install
3. Configure Claude Desktop or any other tools as shown below

---

⚙️ Credential Configuration

Connection String

dynamodb://:@/

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

Environment Variables

1. Export AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY.
2. Supply connection information without credentials in the URI: dynamodb://us-east-1/mcp-notes

---

🤖 Integration with Tools

Claude Desktop

Add this snippet to 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"
      ]
    }
  }
}

or file on local disks:

{
  "mcpServers": {
    "mcp-notes": {
      "command": "node",
      "args": [