mcp-notes-server

mcp-notes-server

あらゆる MCP 対応 AI アシスタントに、メモの作成、一覧表示、検索ができる永続的なノートブックを提供する、Python 製の最小構成の無料オープンソースModel Context Protocol（MCP）サーバーです。メモは、所有者が管理するローカルのプレーンな JSON ファイルに保存されます。

公式の mcp Python SDK（FastMCP）で構築されています。データベースもクラウドもアカウントも不要です。メモがマシンの外に出ることはありません。

ツール

ツール	機能
create_note	タイトル（必須、120 文字以内）と本文（10,000 文字以内）を指定してメモを作成します。ID とタイムスタンプを含む保存済みレコードを返します。
list_notes	保存済みメモを新しい順に一覧表示します（件数は 1～500 の範囲で指定できます）。
search_notes	タイトルと本文を対象に、大文字と小文字を区別せずキーワード検索します。

クイックスタート

git clone <this-repo-url>
cd mcp-notes-server
pip install -r requirements.txt
python server.py

このサーバーは stdio 経由で MCP と通信します。任意の MCP ホストから接続できます。以下および examples/ にある設定例をご覧ください。

Claude Desktop

claude_desktop_config.json に追加してください（examples/claude_desktop_config.example.json をご覧ください）。

{
  "mcpServers": {
    "notes-server": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-notes-server/server.py"]
    }
  }
}

汎用 MCP ホスト

examples/mcp-client-config.generic.json をご覧ください。同じ stdio のコマンド／引数パターンは、ほとんどのホストで使用できます。

試してみる

1. MCP ホストを接続し、次のように尋ねます。「『買い物リスト』というタイトルで、牛乳、卵、コーヒーを含むメモを作成してください。」
2. 次のように尋ねます。「メモの中から卵を検索してください。」
3. notes.json（server.py と同じ場所に自動作成されます）を開いて、生の保存データを確認してください。形式は通常の JSON です。

仕組み

• 保存用ヘルパーが単一の notes.json ファイルを読み込み、保存します。保存はアトミックに行われます（一時ファイルに書き込んでから置き換えます）。
• 各ツールは入力を検証します（タイトルは必須で文字数に上限があり、本文にも文字数の上限があり、検索クエリは必須です）。
• ツール関数は、@mcp.tool() デコレーターが付いた通常の Python 関数です。型アノテーションがツールの入力スキーマになります。サーバー全体は読みやすい単一ファイル（約 150 行）で構成されており、コピーして応用できるように設計されています。

スモークテストを実行します（MCP ホストは不要です）。

python tests/smoke_test.py

実際の MCP プロトコル（stdio、公式 SDK v1.x）で、エンドツーエンドの動作を確認済みです。ツールの一覧表示、メモの作成、検索、一覧表示を実行します。tests/mcp_e2e_test.py を参照し、pip install -r requirements.txt の後にご自身でも実行してください。requirements で mcp<2 に固定している点にご注意ください。2.x SDK では FastMCP の名前が変更されており、このコードは v1 API を対象としています。

範囲と安全性

• ローカルのみです。 このサーバーは自身のフォルダーにある単一の JSON ファイルを読み書きします。ネットワーク通信は行わず、削除ツールもありません。これはスターターパターンとして意図された設計です。
• 堅牢化された本番サービスではなく、学習やプロトタイピングの土台としてご利用ください。認証はありません（stdio サーバーはホストによって、ホストを実行するユーザーとして起動されます）。アトミックなファイル置き換え以外に、並行処理のロック機構もありません。

フルパックを入手する

この無料サーバーは、MCP Server Starter Templates パックに含まれる 3 つのスターターのうちの 1 つです。フルパックには、読み取り専用の SQLite 検索サーバー（テスト済みの SQL インジェクション対策ガード：SELECT のみを許可する検証）と Web 要約サーバーのスケルトンに加え、3 つすべてのクライアント設定、テストチェックリスト、本番環境に向けて MCP サーバーを整備するためのセキュリティノートが含まれます。

→ MCP Server Starter Templates（さらに、AgentProof テストキット、LLM/RAG 評価キット、エージェント向け検証済みデータセットなどの AI エージェントツールもあります）：bradray2.gumroad.com

有料キットの無料サンプルは、関連リポジトリ ai-agent-tools-free-samples で公開されています。

ライセンス

MIT — LICENSE をご覧ください。ご自由にお使いいただき、フォークして、公開してください。

Copyright (c) 2026 Brad Lucas.