MCP Notes Server
MCP ノートサーバー
永続ストレージを使用してメモを管理するためのモデル コンテキスト プロトコル (MCP) サーバー実装。
特徴
メモの作成、閲覧、更新、削除
JSONを使用した永続ストレージ
作成と変更のタイムスタンプ追跡
プロンプトによるメモの要約
note:// URIスキームを使用したリソースベースのアクセス
Related MCP server: Beeper MCP Note Server
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop のノートを自動的にインストールするには:
npx -y @smithery/cli install notes --client claude手動インストール
Python 3.10以降がインストールされていることを確認してください
仮想環境を作成します。
python -m venv .venv # On Unix/MacOS: source .venv/bin/activate # On Windows: .venv\Scripts\activateインストール要件:
pip install MCP
プロジェクト構造
notes/
├── __init__.py # Package initialization
├── server.py # Main server implementation
├── storage.py # Note persistence layer
├── resources.py # Resource handling (note:// URIs)
├── prompts.py # LLM prompt generation
└── tools/ # Server tools
├── __init__.py # Tools package initialization
├── list_tools.py # Tool listing functionality
└── handle_tools.py # Tool handling implementation利用可能なツール
add-note: 新しいメモを作成するlist-all-notes: 保存されているすべてのメモを表示するupdate-note: 既存のノートを変更するdelete-note: メモを削除する
使用法
サーバーを起動します。
mcp install src/notes mcp start Notes操作例:
# Create a note await client.call_tool("add-note", { "name": "example", "content": "This is a test note" }) # List all notes await client.call_tool("list-all-notes") # Update a note await client.call_tool("update-note", { "name": "example", "content": "Updated content" }) # Delete a note await client.call_tool("delete-note", { "name": "example" })
ストレージ
メモは次の構造でnotes_storage.jsonに保存されます。
{
"note_name": {
"content": "Note content",
"created_at": "2025-01-12T11:28:16.721704",
"modified_at": "2025-01-12T11:28:16.721704"
}
}リソースアクセス
ノートにはnote:// URI スキームを使用してリソースとしてアクセスできます。
リソースの一覧表示: 利用可能なすべてのノートをリソースとして返します
リソースの読み取り:
note://internal/note_nameを使用して特定のノートにアクセスします。
プロンプト生成
サーバーには、メモの要約のためのプロンプト生成機能が含まれています。
簡潔な要約と詳細な要約の両方をサポート
言語モデル入力のフォーマットノート
「summarize-notes」プロンプトから利用可能
発達
サーバーを変更または拡張するには:
リポジトリをクローンする
開発依存関係をインストールする
適切なモジュールに変更を加える
展開前に徹底的にテストする
テスト
テストでは以下をカバーします:
基本的なCRUD操作
複数のノートの取り扱い
エラーケース
リソースアクセス
プロンプト生成
ライセンス
[ここにライセンスを追加]
Available Tools
4 toolsadd-noteC
Create a new note
Inputs: content (required), name (required).
delete-noteC
Delete an existing note
Inputs: name (required).
list-all-notesB
Read all stored notes
Inputs: no named parameters.
update-noteC
Update an existing note
Inputs: content (required), name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose targeting specific CRUD operations on notes: add-note for creation, delete-note for deletion, list-all-notes for reading all, and update-note for updates. There is no overlap in functionality, making tool selection unambiguous.
The tools follow a mostly consistent verb-noun pattern (add-note, delete-note, update-note), but list-all-notes deviates slightly by including 'all'. This minor inconsistency does not significantly hinder readability or predictability.
With 4 tools, the server is well-scoped for a notes management system, covering the essential CRUD operations. Each tool earns its place without being overly sparse or bloated, fitting the typical 3-15 tool range appropriately.
The tool set provides complete CRUD coverage for the notes domain: create (add-note), read (list-all-notes), update (update-note), and delete (delete-note). There are no obvious gaps, allowing agents to handle full note lifecycles without dead ends.
Maintenance
Related MCP Connectors
An MCP server that used to create notes
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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.5-
- FlicenseNot gradedqualityDmaintenanceA simple MCP server for creating and managing notes with support for summarization functionality.1-
- FlicenseBqualityDmaintenanceA simple note-taking MCP server that stores notes and can generate summaries of stored content.4-
- FlicenseNot gradedqualityNot gradedmaintenanceA simple MCP server that implements a note storage system allowing users to add and summarize notes with customizable detail levels.3-