🧠 Custom MCP Server for AI-Powered Sticky Notes

---

📖 NoteFlow とは？

NoteFlow は、AI ワークフローに保存可能な付箋を導入するために設計されたカスタム MCP（Model Context Protocol）サーバーです。

別々のアプリでメモを手作業で管理する代わりに、ユーザーは自然言語を使って、AI アシスタントにメモの作成、保存、取得を依頼するだけで済みます。

Claude Desktop などの AI クライアントと連携すると、NoteFlow によってアシスタントは次のことができます。

• リマインダーを保存する
• アイデアを保存する
• 以前に保存したメモを取得する
• 会話をまたいでコンテキストを保持する

すべてのメモはシンプルな .txt ファイルにローカル保存されるため、システムは軽量で透明性が高く、完全にカスタマイズ可能です。

---

✨ 特長

特長	説明
🧠 カスタム MCP サーバー	FastMCP を使用して、完全に機能する MCP サーバーを実装します
📝 自然言語によるメモの作成	AI アシスタントがコマンドから直接メモを追加できます
📖 メモの取得	保存済みのメモをすぐに取得できます
💾 永続ストレージ	メモはローカルの .txt ファイルに保存されます
⚡ 高速な Python 環境	最新の uv パッケージマネージャーを使用します
🔗 Claude Desktop との連携	Claude 内にツールを自動登録します
🧩 拡張しやすい設計	メモの削除、タグ付け、分類などの新しいツールを簡単に追加できます

---

🏗️ システムアーキテクチャ

リクエストの流れ

graph TD
    A[👤 User Prompt] --> B[Claude Desktop AI]
    B --> C[MCP Client]
    C --> D[Custom MCP Server - FastMCP]
    D --> E{Command Type}

    E -->|Add Note| F[Write to notes.txt]
    E -->|Retrieve Notes| G[Read notes.txt]
    E -->|List Notes| H[Parse Stored Notes]

    F --> I[Return Confirmation]
    G --> I
    H --> I

    I --> B

---

MCP ワークフロー

MCP サーバーは、AI クライアントが呼び出せるカスタムツールを公開します。

1️⃣ ユーザーが AI アシスタントにメモの保存または取得を依頼します 2️⃣ アシスタントが MCP 経由でツールリクエストを送信します 3️⃣ FastMCP サーバーがリクエストを処理します 4️⃣ メモが notes.txt に書き込まれるか、そこから取得されます 5️⃣ 応答が AI クライアントに返されます

このアーキテクチャにより、AI アシスタントはローカルツールと安全かつ効率的に連携できます。

---

🛠️ 技術スタック

バックエンドの中核

コンポーネント	技術
プログラミング言語	Python 3.12
MCP サーバーフレームワーク	FastMCP
パッケージマネージャー	uv
ストレージ	ローカルの .txt ファイル
AI クライアント連携	Claude Desktop

---

📂 プロジェクト構成

ai-sticky-notes-mcp/
│
├── main.py            # MCP server logic (tools, prompts, handlers)
├── notes.txt          # Persistent storage for sticky notes
└── README.md          # Project documentation

---

🚀 インストールとセットアップ

前提条件

• Python 3.12+
• Claude Desktop（任意ですが、推奨）

---

1️⃣ uv をインストールする

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Mac / Linux（curl）

curl -LsSf https://astral.sh/uv/install.sh | sh

または wget を使用

wget -qO- https://astral.sh/uv/install.sh | sh

---

2️⃣ プロジェクトを初期化する

uv init .

---

3️⃣ MCP の依存関係を追加する

uv add "mcp[cli]"

---

🏃 MCP サーバーを実行する

すべてのサーバーロジックを main.py に記述します。

次に、MCP サーバーをインストールします。

uv run mcp install main.py

これにより MCP サーバーが登録され、AI クライアントが自動的に検出できるようになります。

---

🔗 Claude Desktop との統合

Claude Desktop がインストールされている場合：

1️⃣ 次を実行します：

uv run mcp install main.py

2️⃣ Claude が MCP サーバーを自動的に検出します。

3️⃣ ツールが表示されない場合は、Claude を再起動します：

• タスク マネージャーを開きます
• Claude Desktop のプロセスを終了します
• アプリを再起動します

これで MCP ツールを利用できるようになります。

---

🌐 MCP ツールの例

サーバーでは、次のようなツールを公開できます：

ツール	説明
add_note	新しい付箋を保存する
get_notes	すべてのメモを取得する
search_notes	キーワードを含むメモを検索する

対話の例：

User: Remember that I need to finish my ML assignment tonight.

Claude: Note saved successfully.

---

⚙️ 設定

設定	ファイル	説明
メモの保存	notes.txt	メモを保存するローカルファイル
MCP ツール	main.py	ツールとコマンドを定義する
クライアント統合	Claude Desktop	MCP サーバーを自動的に登録する

---

🐛 既知の問題とトラブルシューティング

Claude に MCP サーバーが表示されない

Claude デスクトップアプリケーションを再起動します：

1. タスク マネージャーを開きます
2. Claude のプロセスを終了します
3. アプリを再起動します

---

メモが保存されない

次の点を確認してください：

• プロジェクトディレクトリに notes.txt が存在する
• MCP サーバーにファイルへの書き込み権限がある

---

🔮 今後の改善

• 📂 メモのタグ付けと分類
• 🧠 埋め込み表現を使用したセマンティック検索
• 🗑️ メモの削除または編集
• ☁️ クラウドストレージとの統合
• 🔗 マルチエージェント MCP ワークフロー

---