📝 MCPノート

✨ 概要

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

このプロジェクトには、AI 駆動型メモ管理用のモデル コンテキスト プロトコル (MCP) を使用する Node.js サーバーと、メモを手動で操作するためのユーザーフレンドリーなインターフェイスを提供する Web サーバーの 2 つのサーバーが含まれています。

**注:**このプロジェクトでは、メモの保存に DynamoDB が必要です。ご利用には AWS アカウントが必要です。AWS は DynamoDB に十分な無料利用枠を提供しているため、頻繁に個人でご利用いただく場合でも無料でご利用いただけます。

Related MCP server: Beeper MCP Note Server

🎯 コア機能

• 🖥️デュアルサーバーアーキテクチャ: AI駆動型ノート管理用のMCPサーバーとユーザーインターフェース用のWebサーバー

• 🤖 AI を活用したメモ作成: AI とのやり取りを通じて、考え、洞察、タスクを記録します

• 🗂️包括的なメモ管理: AI または Web インターフェースを介してメモを作成、一覧表示、取得、更新、削除します

• 📋信頼性の高いストレージ: AWS DynamoDB による安全で効率的なノートストレージ

• 🔐**柔軟な認証:**接続文字列または環境変数を介した AWS 認証情報のサポート

• 📝**プロジェクトに依存しない:**プロジェクトファイルや構造に影響を与えずに個人的なメモを保存できます

🤖 モデルサポート

クライアントがMCPをサポートしていれば、関数呼び出しをサポートする任意のモデルを使用できます。以下のモデルはテスト済みで動作確認済みです。

• クロード3.5シリーズ

• ジェミニ1.5および2.0シリーズ

• GPT-4シリーズ

• ミストラル ラージ

• グロク2

• ディープシークチャット

🛠️ インストール

推奨

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_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 の MCP サーバー サポートは制限されています。
サーバー接続は1つしか許可されておらず、ツール呼び出しはできません。メモを作成・管理し、AIチャットでの会話で参照するには、Webインターフェースを使用する必要があります。

次のスニペットを 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_mcp_settings.jsonに追加します。

「新しいタスク」ボタンの横に「MCP サーバー」アイコンがあり、このファイルを開くための「MCP 設定の編集」ボタンがあります。

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

🚀 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ツール

リストノート

• 入力: { tags?: string[] }

• **出力:**すべてのメモの配列。オプションでタグでフィルタリングされます。

ゲットノート

• 入力: { id: string }

• **出力:**指定された ID に一致する単一のノート オブジェクト、または一致するものが存在しない場合は「見つかりません」というメッセージ。

メモを書く

• 入力: { id: string, title: string, summary: string, tags: string[], content: string }

• **出力:**成功確認メッセージ。

削除メモ

• 入力: { id: string }

• **出力:**削除確認メッセージ🚮。

📝 データ構造

メモは次の構造を使用して保存されます。

• id : メモの一意の識別子。「meeting-notes-1362」のように、ランダムな数字の接尾辞が付いた、わかりやすい名前にしてください。

• title : メモのタイトル。

• summary : メモの内容の短い要約。

• tags : メモに関連付けられたタグの配列 (例: ["meeting", "project-x"])。

• content : ノートの主な内容。

📸 スクリーンショット

クロードデスクトップ

✅ フル機能

コーディ

✅ リソース経由でメモをメンションする

❎ ツール呼び出しはサポートされていません

クライン

✅ ツールコールによるフル機能

❓ リソースが機能していないようです。助けが必要です。