Skip to main content
Glama
Sign In
deenesjakoruzh

MCP Notes

by 9Ninety
npmGitHub
TypeScript
GPL 2.0
66
21
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • The README shows a command for running the web server using Bun as an alternative runtime: 'bun src/notes-web-server.ts --dynamodb ...'

  • The README mentions Node.js multiple times as the primary runtime for the MCP server, with instructions for configuration in various clients.

  • The README shows integration with npm through the use of npx commands to run the MCP Notes server and web server.

📝 MCP-Hinweise

✨ Übersicht

MCP Notes Server ist eine einfache Notizanwendung, die auf dem MCP-Protokoll basiert. Sie ermöglicht es Nutzern, komplexe Notizen und Aufgaben mithilfe von KI-Modellen aufzuzeichnen und anzuzeigen, beispielsweise persönliche Gedanken, Notizen, Inspirationen und Erkenntnisse. Die Anwendung benötigt keine Projektdateien und ermöglicht es Nutzern, beliebige Inhalte aufzuzeichnen, ohne diese innerhalb des Projekts öffentlich zugänglich zu machen.

Dieses Projekt umfasst zwei Server: einen Node.js-Server, der das Model Context Protocol (MCP) für die KI-gesteuerte Notizverwaltung verwendet, und einen Webserver, der eine benutzerfreundliche Oberfläche für die manuelle Interaktion mit Ihren Notizen bietet.

Hinweis: Dieses Projekt benötigt DynamoDB zur Notizenspeicherung. Sie benötigen hierfür ein AWS-Konto. AWS bietet ein großzügiges kostenloses Kontingent für DynamoDB an, sodass es sich für die häufige private Nutzung ohne Kosten eignet.

🎯 Kernfunktionen

  • 🖥️ Dual-Server-Architektur: MCP-Server für KI-gesteuertes Notizmanagement und Webserver für die Benutzeroberfläche
  • 🤖 KI-gestütztes Notieren: Halten Sie Gedanken, Erkenntnisse und Aufgaben durch KI-Interaktionen fest
  • 🗂️ Umfassende Notizverwaltung: Erstellen, Auflisten, Abrufen, Aktualisieren und Löschen von Notizen über KI oder Weboberfläche
  • 📋 Zuverlässiger Speicher: Sichere und effiziente Notizenspeicherung mit AWS DynamoDB
  • 🔐 Flexible Authentifizierung: Unterstützung für AWS-Anmeldeinformationen über Verbindungszeichenfolgen oder Umgebungsvariablen
  • 📝 Projektunabhängig: Speichern Sie persönliche Notizen, ohne Projektdateien oder -struktur zu beeinträchtigen

🤖 Modellunterstützung

Sie können jedes Modell verwenden, das Funktionsaufrufe unterstützt, solange Ihr Client MCP unterstützt. Die folgenden Modelle wurden getestet und ihre Funktionsfähigkeit bestätigt:

  • Claude 3.5 Serie
  • Gemini 1.5 und 2.0 Serie
  • GPT-4-Serie
  • Mistral Large
  • Grok-2
  • DeepSeek-Chat

🛠️ Installation

Empfohlen

Führen Sie es direkt mit npx oder bunx aus, siehe Beispiele unten.

Alternative

  1. Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist.
  2. Klonen Sie dieses Repository und installieren Sie Abhängigkeiten mit: npm install
  3. Konfigurieren Sie Claude Desktop oder andere Tools wie unten gezeigt

⚙️ Anmeldeinformationskonfiguration

Verbindungszeichenfolge

dynamodb://<access_key>:<secret_key>@<region>/<table>

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

Umgebungsvariablen

  1. Exportieren Sie AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY .
  2. Geben Sie Verbindungsinformationen ohne Anmeldeinformationen in der URI an: dynamodb://us-east-1/mcp-notes

🤖 Integration mit Tools

Claude Desktop

Fügen Sie diesen Codeausschnitt zu claude_desktop_config.json hinzu:

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

oder Datei auf lokalen Datenträgern:

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

Cody

Hinweis: Derzeit bietet Cody nur eingeschränkte MCP-Serverunterstützung.
Es ist nur eine Serververbindung möglich und es können keine Tool-Aufrufe durchgeführt werden. Sie müssen die Weboberfläche verwenden, um Notizen zu erstellen und zu verwalten und diese dann in KI-Chat-Konversationen zu referenzieren.

Fügen Sie diesen Codeausschnitt zu Ihren VS Code-Einstellungen hinzu:

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

alternativ mit npx verwenden (Funktion nicht garantiert):

{ "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

Fügen Sie diesen Codeausschnitt zu cline_mcp_settings.json hinzu:

Neben der Schaltfläche „Neue Aufgabe“ finden Sie ein „MCP-Server“-Symbol und dann eine Schaltfläche „MCP-Einstellungen bearbeiten“, um diese Datei zu öffnen.

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

🚀 Ausführen von Webservern

Der Webserver bietet eine benutzerfreundliche Oberfläche zur Verwaltung Ihrer Notizen. Sie können Weboberflächen starten, um Ihre Notizen zu verwalten, neue Notizen für die KI hinzuzufügen oder Teile der von der KI generierten Notizen zu ändern.

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"

Alternativ können Sie mit npm run build kompilieren und node dist/notes-mcp-server.js oder node dist/notes-web-server.js ausführen.

Navigieren Sie dann in Ihrem Browser zu http://localhost:3100 um Notizen anzuzeigen.

🔧 Verfügbare MCP-Tools

ListeNotizen

  • Eingabe: { tags?: string[] }
  • Ausgabe: Array aller Notizen, optional nach Tags gefiltert.

getNote

  • Eingabe: { id: string }
  • Ausgabe: Ein einzelnes Notizobjekt, das mit der angegebenen ID übereinstimmt, oder eine „Nicht gefunden“-Meldung, wenn keine Übereinstimmung vorhanden ist.

SchreibeNotiz

  • Eingabe: { id: string, title: string, summary: string, tags: string[], content: string }
  • Ausgabe: Eine Erfolgsbestätigungsmeldung.

Hinweis löschen

  • Eingabe: { id: string }
  • Ausgabe: Löschbestätigungsnachricht 🚮.

📝 Datenstruktur

Notizen werden mit der folgenden Struktur gespeichert:

  • id : Eine eindeutige Kennung für die Notiz. Sie sollte beschreibend sein und ein zufälliges Zahlensuffix enthalten, z. B. „meeting-notes-1362“.
  • title : Der Titel der Notiz.
  • summary : Eine kurze Zusammenfassung des Inhalts der Notiz.
  • tags : Ein Array von Tags, die mit der Notiz verknüpft sind (z. B. ["Meeting", "Projekt-x"]).
  • content : Der Hauptinhalt der Notiz.

📸 Screenshots

Claude Desktop

✅ Volle Funktionalität

Cody

✅ Erwähnen Sie Notizen über die Ressource

❎ Tool-Aufrufe werden nicht unterstützt

Cline

✅ Volle Funktionalität mit Tool Calls

❓ Ressourcen scheinen nicht zu funktionieren; Hilfe erwünscht.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Ein einfacher MCP-Server zum Aufzeichnen und Verwalten von Notizen mit KI-Modellen.

  1. ✨ Übersicht
    1. 🎯 Kernfunktionen
      1. 🤖 Modellunterstützung
        1. 🛠️ Installation
          1. ⚙️ Anmeldeinformationskonfiguration
            1. Verbindungszeichenfolge
            2. Umgebungsvariablen
          2. 🤖 Integration mit Tools
            1. Claude Desktop
            2. Cody
            3. Cline
          3. 🚀 Ausführen von Webservern
            1. 🔧 Verfügbare MCP-Tools
              1. ListeNotizen
              2. getNote
              3. SchreibeNotiz
              4. Hinweis löschen
            2. 📝 Datenstruktur
              1. 📸 Screenshots
                1. Claude Desktop
                2. Cody
                3. Cline

              Related MCP Servers

              • Weather Service MCP Server

                Sunwood-ai-labs
                -
                security
                F
                license
                -
                quality
                A simple note-taking MCP server that allows storing and summarizing notes with custom URI schemes and provides functionality to add notes and generate summaries with different detail levels.
                Last updated -
                5
                Python
                • Apple

              • ClickUp Operator

                noah-vh
                -
                security
                F
                license
                -
                quality
                A Claude-compatible MCP server that enables storing and summarizing notes through a simple note storage system with custom URI scheme.
                Last updated -
                3
                Python

              • Beeper MCP Note Server

                stopWarByWar
                -
                security
                -
                license
                -
                quality
                A simple MCP server for creating and managing notes with support for summarization functionality.
                Last updated -
                Python

              • Soduku Solver MCP Server

                Skywalker-Harrison
                -
                security
                F
                license
                -
                quality
                A simple MCP server implementing a note storage system with one tool to add notes and one prompt to summarize stored notes.
                Last updated -
                1
                Python
                • Apple

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              ID: 4c63qdbh55