📝 MCP Notes

📝 MCP Notes

✨ 概要

MCP Notes Server は、MCP プロトコル上に構築されたシンプルなメモアプリケーションです。個人的な考え、メモ、ひらめき、洞察の記録など、AI モデルを活用しながら、複雑なメモやタスクを記録・表示できるようにすることを目的としています。プロジェクトファイルの作成には依存しないため、プロジェクト内で公開することなく、あらゆる内容を記録できます。

このプロジェクトには 2 つのサーバーが含まれています。AI を活用したメモ管理に Model Context Protocol（MCP）を使用する Node.js サーバーと、メモを手動で操作するための使いやすいインターフェースを提供する Web サーバーです。

注： このプロジェクトでは、メモの保存に DynamoDB が必要です。利用するには AWS アカウントが必要です。AWS は DynamoDB に充実した無料利用枠を提供しているため、個人で頻繁に利用する場合も無料で使用できます。

---

🎯 主な機能

• 🖥️ デュアルサーバーアーキテクチャ： AI を活用したメモ管理用の MCP サーバーと、ユーザーインターフェース用の Web サーバー
• 🤖 AI を活用したメモ作成： AI とのやり取りを通じて、考え、洞察、タスクを記録
• 🗂️ 包括的なメモ管理： AI または Web インターフェースから、メモの作成、一覧表示、取得、更新、削除が可能
• 📋 信頼性の高いストレージ： AWS DynamoDB による安全で効率的なメモの保存
• 🔐 柔軟な認証： 接続文字列または環境変数による AWS 認証情報に対応
• 📝 プロジェクトから独立： プロジェクトファイルや構成に影響を与えず、個人のメモを保存

---

🤖 モデルのサポート

クライアントが MCP をサポートしていれば、関数呼び出しに対応するあらゆるモデルを使用できます。以下のモデルでテストし、動作を確認しています。

• Claude 3.5 Series
• Gemini 1.5 and 2.0 Series
• GPT-4 Series
• Mistral Large
• Grok-2
• DeepSeek Chat

---

🛠️ インストール

推奨

npx または bunx で直接実行します。例は以下をご覧ください。

代替方法

1. システムに Node.js がインストールされていることを確認します。
2. このリポジトリをクローンし、次のコマンドで依存関係をインストールします：npm install
3. 以下の手順に従って、Claude Desktop またはその他のツールを設定します

---

⚙️ 認証情報の設定

接続文字列

dynamodb://<access_key>:<secret_key>@<region>/<table>

例：dynamodb://AKIAXXXXXXXX:SKXXXXXXXX@us-east-1/mcp-notes

環境変数

1. AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY をエクスポートします。
2. URI に認証情報を含めず、接続情報を指定します：dynamodb://us-east-1/mcp-notes

---

🤖 ツールとの連携

Claude Desktop

次のスニペットを claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "mcp-notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

またはローカルディスク上のファイルに追加します：

{
  "mcpServers": {
    "mcp-notes": {
      "command": "node",
      "args": [
        "file://path/to/notes-mcp-server.js",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

Cody

注： 現在、Cody の MCP サーバーサポートには制限があります。
サーバー接続は 1 つのみで、ツール呼び出しはできません。メモの作成・管理には Web インターフェースを使用し、AI チャットでの会話時にメモを参照する必要があります。

次のスニペットを VS Code の設定に追加します：

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file://path/to/notes-mcp-server.js",
      "mcp.provider.args": [
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

または、npx を使用して実行します（動作は保証されません）：

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file:///usr/local/bin/npx",
      "mcp.provider.args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

Cline

次のスニペットを cline_mcp_settings.json に追加します：

「New Task」ボタンの横に「MCP Server」アイコンがあります。そこから「Edit MCP Settings」ボタンをクリックすると、このファイルを開けます。

{
  "mcpServers": {
    "mcp-notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

---

🚀 Web サーバーの実行

Web サーバーは、メモを管理するための使いやすいインターフェースを提供します。Web インターフェースを起動すると、メモの管理、AI 用の新しいメモの追加、AI が生成したメモの一部の変更ができます。

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"

bun src/notes-web-server.ts --dynamodb "dynamodb://access_key:secret_key@region/table"

または、npm run build でコンパイルしてから、node dist/notes-mcp-server.js または node dist/notes-web-server.js を実行します

その後、ブラウザーで http://localhost:3100 にアクセスすると、メモを表示できます。

---

🔧 利用可能な MCP ツール

listNotes

• 入力： { tags?: string[] }
• 出力： すべてのメモの配列。タグによる絞り込みも可能です。

getNote

• 入力： { id: string }
• 出力： 指定された ID に一致する単一のメモオブジェクト。一致するものがない場合は「見つかりません」というメッセージが返されます。

writeNote

• 入力: { id: string, title: string, summary: string, tags: string[], content: string }
• 出力: 成功を確認するメッセージ。

deleteNote

• 入力: { id: string }
• 出力: 削除を確認するメッセージ 🚮。

---

📝 データ構造

ノートは次の構造で保存されます。

• id: ノートの一意の識別子です。「meeting-notes-1362」のように、説明的な名前とランダムな数字の接尾辞を付けてください。
• title: ノートのタイトルです。
• summary: ノートの内容を短くまとめたものです。
• tags: ノートに関連付けられたタグの配列です（例：["meeting", "project-x"]）。
• content: ノートの本文です。

---

📸 スクリーンショット

Claude Desktop

✅ すべての機能を利用できます

Cody

✅ リソース経由でノートに言及できます

❎ ツール呼び出しには対応していません

Cline

✅ ツール呼び出しを含むすべての機能を利用できます

❓ リソースは動作しないようです。ご協力をお願いします。