mcp-server-sample
mcp-server-sample — Minimaler MCP-Server zum Speichern und Durchsuchen von Notizen
Ein minimaler MCP-Server, der nur Notizen speichert und durchsucht. Er verbindet sich mit keinem externen System.
Der Speicherort ist nur eine Datei notes.json im selben Ordner.
Er enthält jeweils ein Beispiel für die drei MCP-Primitive.
Primitive | Wer entscheidet | Inhalt auf diesem Server |
Tools | Das Modell entscheidet |
|
Resources | Die KI-App ruft sie ab und übergibt sie |
|
Prompts | Der Benutzer wählt explizit aus |
|
Voraussetzungen
Node.js 24 oder höher (LTS. Überprüfen mit
node --version)git
Related MCP server: mcp-snippetbox
Einrichtung
git clone https://github.com/utakatano/mcp-server-sample.git
cd mcp-server-sample
npm installWenn npm install erfolgreich war, ist die Einrichtung abgeschlossen. Zu diesem Zeitpunkt wird der Server nicht gestartet.
Der MCP-Server wird von der KI-App gestartet, daher muss er nicht manuell über das Terminal ausgeführt werden.
Mit der KI-App verbinden
Claude Code
claude mcp add notes -- node /絶対パス/mcp-server-sample/index.jsWenn claude mcp list ✔ Connected anzeigt, ist die Verbindung hergestellt.
Claude Desktop
Einstellungen → Developer → „Edit Config“ öffnet claude_desktop_config.json. Fügen Sie Folgendes hinzu:
{
"mcpServers": {
"notes": {
"command": "node",
"args": ["/絶対パス/mcp-server-sample/index.js"]
}
}
}Nach dem Speichern Claude Desktop vollständig beenden und neu starten (nur das Schließen des Fensters reicht nicht).
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Funktionstest
「来週までにネットワーク構成を確認する」とメモして「ネットワーク」を含むメモを探してEs wird eine notes.json erstellt, deren Inhalt nach und nach wächst.
Speicherort ändern
Durch die Umgebungsvariable NOTES_FILE mit einem absoluten Pfad kann der Speicherort geändert werden.
{
"mcpServers": {
"notes": {
"command": "node",
"args": ["/絶対パス/mcp-server-sample/index.js"],
"env": { "NOTES_FILE": "/絶対パス/my-notes.json" }
}
}
}Wenn keine Verbindung zustande kommt
Zuerst das Log prüfen. Die Ursache steht meistens dort.
tail -20 ~/Library/Logs/Claude/mcp-server-notes.log # macOS
# Windows: %APPDATA%\Claude\logs\mcp-server-notes.logAchten Sie darauf, ob nach Server started and connected successfully ein Fehler auftritt.
Im Log angezeigt | Ursache | Lösung |
| Der Pfad in | Führen Sie |
| Die KI-App findet | Geben Sie die Ausgabe von |
| Abhängigkeiten nicht installiert | Führen Sie im Repository-Stammverzeichnis |
Log ist leer oder wird nicht aktualisiert | Die Konfiguration wird nicht geladen | Überprüfen Sie die JSON-Syntax (Kommas, Klammern) und beenden Sie Claude Desktop vollständig (macOS: ⌘Q) und starten Sie es neu |
Zur Unterscheidung, ob der Fehler serverseitig oder seitens der KI-App liegt, ist es am schnellsten, den Server lokal direkt aufzurufen.
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}\n' \
| node /絶対パス/mcp-server-sample/index.jsWenn ein JSON mit add_note und search_notes zurückgegeben wird, funktioniert der Server korrekt. In diesem Fall prüfen Sie die Einstellungen der KI-App (Pfad, JSON-Format, Neustart).
Maßnahmen gegen Lieferkettenangriffe
In der .npmrc sind Einstellungen enthalten, die eine Übernahme von npm-Paketen verhindern sollen. Sie wirken bei jedem npm install / npm ci.
Einstellung | Wirkung |
| Führt bei der Installation keine Lebenszyklus-Skripte von Abhängigkeiten (z.B. |
|
|
| Installiert nur Versionen, die älter als 7 Tage sind. npm wandelt dies in |
Die Abhängigkeiten sind in package.json vollständig fixiert (@modelcontextprotocol/server ist 2.0.0, zod ist 4.4.3),
und in package-lock.json mit integrity-Hash protokolliert.
Wenn Sie die Abhängigkeiten genau wie im Lockfile installieren möchten, verwenden Sie npm ci anstelle von npm install.
Wenn Sie Abhängigkeiten aktualisieren möchten, heben Sie sie bewusst einzeln an.
npm outdated
npm install @modelcontextprotocol/server@2.1.0 # save-exact により完全固定で書かれる
npm ls --all # 増えた依存を目で確認するLizenz
MIT
Available Tools
2 toolsadd_noteメモを追加するA
メモを1件保存する。打ち合わせの決定事項や、あとで思い出したいことを記録するときに使う。
Inputs: text (required), tags.
search_notesメモを検索するB
保存済みのメモをキーワードで検索する。本文とタグの両方を対象にする。
Inputs: keyword (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one creates/ stores a note, the other retrieves notes via search. There is no overlap or ambiguity between writing and searching.
Both tool names follow a consistent verb_noun pattern (add_note, search_notes) using lowercase with underscores. The naming is predictable and clear.
With only 2 tools, the set feels minimal. While the tools cover basic create and read/search operations, the server's purpose (saving and retrieving notes) could reasonably include more tools (e.g., update, delete, list tags) to avoid being overly thin.
The domain is a personal note-taking system, but only add and search operations are provided. Missing critical operations like update, delete, and get all notes (without search) create significant gaps that would frustrate or block a typical agent workflow.
Maintenance
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables adding, getting, and listing notes through MCP, with state persisted to a JSON file in the home directory.MIT
- AlicenseNot gradedqualityCmaintenanceEnables managing notes through a simple MCP server, providing tools to add, retrieve, update, delete, and list notes for use with Claude Desktop.MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to create, list, and search notes stored in a local JSON file through the Model Context Protocol.-
- AlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to add, retrieve, update, delete, and list notes persisted in a JSON file whose path is set via MCP_NOTES_FILE or --notes-file, with atomic, lock-protected saves.MIT