✨ 개요

MCP Notes Server는 MCP 프로토콜의 최상위에 내장된 간단한 노트 스테이킹 응용 프로그램입니다. 이 목적은 사용자가 개인의 생각, 노트, 영감 및 통찰력을 기록하면서 복잡한 노트와 작업을 기록하고 볼 수 있도록 합니다. 프로젝트 파일을 만들기에 의존하지 않습니다. 사용자는 프로젝트 내에서 공개하지 않고 콘텐츠를 기록 할 수 있습니다.

이 프로젝트에는 두 개의 서버가 포함되어 있습니다. Node.js 서버는 AI 기반 메모 관리 및 웹 서버를 위해 Model Context Protocol (MCP)을 사용하여 노트와 수동 상호 작용을 위한 사용자 친화적 인 인터페이스를 제공합니다.

주의: 이 프로젝트는 DynamoDB를 참고 저장소에 요구합니다. AWS 계정이 필요합니다. AWS는 DynamoDB를 위한 관대한 자유로운 층을, 비용 없이 빈번한 개인적인 사용을 위해 적당한 제안합니다.

---

핵심 특징

• ⌘ Dual Server Architecture: 사용자 인터페이스를 위한 AI 기반 메모 관리 및 웹 서버를 위한 MCP 서버
• AI-Powered Note 촬영: AI의 상호 작용을 통해 생각, 통찰력 및 작업 기록
• ️️ 저렴한 주의 관리: Create, list, retrieve, update, and delete notes via 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": [