Notes

🚀 MCP Notes Project Documentation

This project offers a note management tool based on the model context protocol. It enables users to efficiently manage their notes with a range of useful features.

🚀 Quick Start

The MCP Notes project provides a comprehensive note management solution. You can start using it by following the installation and running steps below.

✨ Features

• Support for integrating multiple AI models.
• A web interface for convenient note management.
• A flexible tagging system to categorize notes.
• Persistent data storage to ensure data safety.

📦 Installation

npm install -p mcp-notes

💻 Usage Examples

Basic Usage

npx mcp-notes mcp-notes-server --dynamodb "dynamodb://localhost:8000"

Advanced Usage

npm run build && node dist/notes-mcp-server.js

📚 Documentation

Credential Configuration

Connection String Example:

const dynamodbUri = new URL('http://localhost:8000');

Environment Variable Configuration:

export DYNAMODB_URI=http://localhost:8000

Tool Integration

• Claude Desktop: Fully supports tool invocation and resource display.
• Cody: Only supports mentioning notes, not tool invocation.
• Cline: Fully supports tool invocation, and the resource function is to be verified.

Available Tool Commands

listNotes

• Input: { tags?: string[] }
• Output: A list of notes filtered by tags.

getNote

• Input: { id: string }
• Output: Details of the note with the specified ID or a not-found message.

writeNote

• Input: { id: string, title: string, summary: string, tags: string[], content: string }
• Output: Confirmation message for successful note creation.

deleteNote

• Input: { id: string }
• Output: Prompt indicating the completion of the deletion operation.

Data Structure Definition

Screenshots

Claude Desktop

• Screenshot of the tool invocation function:
• Screenshot of resource display:

Cody

• Screenshot of the note mention function:

Cline

• Screenshot of the tool invocation function: [No image link provided in the original, so it remains the same situation here]