mcp-server-demo (AI sticky notes)

mcp-server-demo（AI 付箋）

AI Sticky Notes：Claude Desktop で付箋を作成、読み取り、管理できる Model Context Protocol（MCP）アプリケーションです。

概要

AI Sticky Notes は Model Context Protocol を活用し、Claude Desktop とシンプルなメモシステムをシームレスに連携します。この実装により、Claude は以下を実行できます。

• メモを永続ストレージに保存する
• 保存済みのすべてのメモを取得する
• 最後に追加されたメモにアクセスする
• 既存のメモを要約するプロンプトを生成する

インストール

前提条件

• Python 3.7+
• MCP Python SDK
• Claude Desktop アプリケーション

セットアップ

1. このリポジトリをクローンします。

   • git clone https://github.com/aymaneELHICHAMI/mcp-server-demo.git
   • cd mcp-server-demo

2. uv をインストールします。

   • ドキュメント：https://docs.astral.sh/uv/getting-started/installation/

3. 仮想環境を作成します。

   • uv venv venv

4. 仮想環境を有効化します。

   • uv venv

5. uv.lock から依存関係をインストールします。

   • uv sync

6. MCP サーバーを実行します。

   • uv run mcp install main.py Claude Desktop に設定が反映されない場合（メニューバー -> 設定 -> 開発者）、タスクマネージャーから Claude Desktop を強制終了して再度開いてみてください。正常に動作すると、「AI Sticky Notes MCP Server」が実行中と表示されます。

コアコンポーネント

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("AI Sticky Notes")

サーバーは MCP エコシステム内で「AI Sticky Notes」として登録され、Claude Desktop などのクライアントから検出できるようになります。

メモはシンプルなテキストファイル（notes.txt）に保存され、各メモは個別の行に記録されます。ファイルが存在しない場合は自動的に作成されます。

サーバーは以下の MCP 機能を公開します。

種類	名前	説明
ツール	add_note	新しいメモをストレージに追加する
ツール	read_notes	既存のすべてのメモを取得する
リソース	notes://latest	最新のメモにアクセスする
プロンプト	note_summary_prompt	メモを要約するためのプロンプトを生成する

Claude Desktop での使用

サーバーが実行されると、Claude Desktop は自動的にサーバーを検出して接続します。自然言語でメモを操作できます。

You: "Please save this as a note: Remember to schedule a team meeting for Friday"
Claude: [Uses add_note tool] "Note saved!"

You: "What notes do I have?"
Claude: [Uses read_notes tool] "Here are your notes: ..."

You: "What was my most recent note?"
Claude: [Accesses notes://latest resource] "Your most recent note is: ..."

You: "Can you summarize my notes?"
Claude: [Uses note_summary_prompt] "Here's a summary of your notes: ..."

リソース

• Model Context Protocol のドキュメント：https://modelcontextprotocol.io/introduction

• FastMCP API リファレンス：https://github.com/jlowin/fastmcp

• Claude Desktop のドキュメント：https://docs.anthropic.com/en/docs/welcome