MCP Notes

🚀 MCPノートサーバー

モデルコンテキストプロトコル（MCP）サーバーの実装で、永続的なストレージを持つノートを管理します。

✨ 主な機能

• ノートの作成、読み取り、更新、削除
• JSONを使用した永続的なストレージ
• 作成および変更のタイムスタンプの記録
• プロンプトを通じたノートの要約生成
• note:// URIスキームを使用したリソースベースのアクセス制御

📦 インストール

Smitheryを通じたインストール

Claude Desktopにノートを自動インストールするには、Smitheryを通じて以下のコマンドを実行します。

npx -y @smithery/cli install notes --client claude

手動インストール

1. Python 3.10以上がインストールされていることを確認します。
2. 仮想環境を作成します。

   python -m venv .venv
   
   # Unix/MacOSの場合：
   source .venv/bin/activate
   
   # Windowsの場合：
   .venv\Scripts\activate
   

3. 必要なパッケージをインストールします。

   pip install MCP
   

📚 ドキュメント

プロジェクト構造

notes/
├── __init__.py          # パッケージの初期化
├── server.py           # メインサーバーの実装
├── storage.py          # ノートの永続層
├── resources.py        # リソースの処理（note:// URI）
├── prompts.py         # LLMプロンプトの生成
└── tools/             # サーバーツール
    ├── __init__.py    # ツールパッケージの初期化
    ├── list_tools.py  # ツールリスト機能
    └── handle_tools.py # ツールの処理実装

利用可能なツール

• add-note：新しいノートを作成します。
• list-all-notes：保存されているすべてのノートを表示します。
• update-note：既存のノートを編集します。
• delete-note：ノートを削除します。

💻 使用例

基本的な使用法

1. サーバーを起動します。

   mcp install src/notes
   mcp start Notes
   

2. 操作の例：

   # ノートを作成する
   await client.call_tool("add-note", {
       "name": "example",
       "content": "これはテスト用のノートです"
   })
   
   # すべてのノートを表示する
   await client.call_tool("list-all-notes")
   
   # ノートを更新する
   await client.call_tool("update-note", {
       "name": "example",
       "content": "更新後の内容"
   })
   
   # ノートを削除する
   await client.call_tool("delete-note", {
       "name": "example"
   })
   

ストレージ

ノートはnotes_storage.jsonに以下の構造で保存されます。

{
    "note_name": {
        "content": "ノートの内容",
        "created_at": "2025-01-12T11:28:16.721704",
        "modified_at": "2025-01-12T11:28:16.721704"
    }
}

リソースアクセス

ノートはnote:// URIスキームを使用してリソースとしてアクセスできます。

• リソースを一覧表示すると、利用可能なすべてのノートが返されます。
• 特定のノートにアクセスするには、note://internal/note_nameを使用します。

プロンプト生成

サーバーには、ノートの要約を生成するためのプロンプト生成機能が備わっています。

• 簡潔な要約と詳細な要約の両方をサポートしています。
• ノートの形式は言語モデルの入力に適しています。
• generate-summaryツールを使用して要約を生成します。

🔧 技術詳細

開発

リポジトリのクローン

以下のコマンドを使用してこのリポジトリをクローンします。

git clone https://github.com/your-username/notes-mcp.git
cd notes-mcp

依存関係

以下のPythonパッケージがインストールされていることを確認してください。

• flask：Webインターフェース用
• python-dotenv：環境変数の管理用
• requests：APIリクエスト用

サーバーの実行

依存関係をインストールした後、以下のコマンドでサーバーを実行します。

python server.py

http://localhost:5000にアクセスすると、Webインターフェースを確認できます。

🤝 貢献

貢献を歓迎します！開発への参加方法については、CONTRIBUTING.mdを参照してください。