Обзор

MCP Notes Server - это простое приложение для заметок, построенное поверх протокола MCP. Его цель состоит в том, чтобы позволить пользователям записывать и просматривать сложные заметки и задачи, используя модели ИИ, такие как запись личных мыслей, заметок, вдохновения и идей. Он не полагается на создание файлов проекта, позволяя пользователям записывать любой контент, не делая его общедоступным в рамках проекта.

Этот проект включает в себя два сервера: сервер Node.js с использованием протокола Model Context Protocol (MCP) для управления заметками на основе ИИ и веб-сервер, обеспечивающий удобный интерфейс для ручного взаимодействия с вашими заметками.

Примечание: Этот проект требует DynamoDB для хранения заметок. Для его использования вам понадобится учетная запись AWS. AWS предлагает щедрый бесплатный уровень для DynamoDB, что делает его пригодным для частого личного использования бесплатно.

Основные характеристики

** Архитектура двойного сервера: ** MCP-сервер для управления заметками на основе ИИ и веб-сервер для пользовательского интерфейса **AI-Powered Note Taking: ** Записывайте мысли, идеи и задачи через взаимодействие с ИИ **Комплексное управление заметками: ** Создавать, перечислять, извлекать, обновлять и удалять заметки с помощью ИИ или веб-интерфейса

📝 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": [