AI Sticky Notes MCP Server

AIアシスタントが個人的なメモを保存・読み取り・要約できるようにするためのMCPサーバーです。メモはサーバーの隣にあるローカルの notes.txt ファイルに保存されます。

機能

• add_note ツール: 新しいメモを追加します。

• read_notes ツール: 保存されたすべてのメモを読み取ります。

• notes://latest リソース: 最後に追加されたメモを取得します。

• note_summary_prompt プロンプト: 現在のメモを含む要約用のプロンプトを作成します。

Related MCP server: Sticky Notes MCP Server

必要条件

• Python 3.12 以降

• pip または uv

ローカルで実行する

uvを使用する

uv sync
uv run python main.py

pipを使用する

仮想環境を作成して有効化し、依存関係をインストールします:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py

サーバーはMCP stdioで通信するため、通常はブラウザで直接開くのではなく、MCP互換クライアントから起動されます。

サーバーをテストする

MCP CLIをインストールした状態で、次のコマンドでMCP Inspectorを起動します:

mcp dev main.py

Inspectorを使用して、add_note と read_notes を呼び出し、notes://latest リソースを開き、note_summary_prompt を実行できます。

Pythonモジュールと構文を直接確認することもできます:

uv run python -c "import main; print('MCP server import ok')"
uv run python -m py_compile main.py

ローカルにデプロイするのを Smithery で行う

リポジトリには smithery.yaml が含まれており、Smitheryがサーバーを次のコマンドで起動するよう設定されています:

startCommand:
	type: stdio
	command: python
	args: ["main.py"]

デプロイファイルをGitHubリポジトリにプッシュし、そのリポジトリをSmitheryでデプロイしてください。重要なファイルは次のとおりです:

• main.py

• requirements.txt

• smithery.yaml

notes.txt は省略可能です。サーバーが必要に応じて自動で作成するため、サンプルのメモを同梱したい場合のみ含めてください。

Docker で実行する

同梱のイメージをビルドして起動します:

docker build -t ai-sticky-notes .
docker run --rm -i ai-sticky-notes

プロジェクト構成

main.py          MCP server implementation
requirements.txt Python dependencies
smithery.yaml    Smithery stdio startup configuration
Dockerfile       Container build configuration
notes.txt        Local note storage, created automatically if absent

保存に関する注意

メモはプレーンテキストファイルに保存されます。これはローカルでの使用やデモに適していますが、ホストされたコンテナでは、再起動や再デプロイ時にファイルが保持されない場合があります。本番環境での永続的な保存には、外部データベースまたは永続ボリュームを使用してください。