MCP Memory Graph Server

MCP Memory Graph Server

概要

Memory Graph Server は、ナレッジグラフ用の永続ストレージレイヤーを提供し、次のことができます。

• エンティティとそのプロパティの保存
• エンティティ間の関係の管理
• グラフ構造のクエリとトラバース
• リアルタイムでの更新と変更

機能

• MongoDB ベースの永続ストレージ
• グラフ操作（作成、読み取り、更新、削除）
• エンティティ管理
• 関係の処理
• クエリ機能
• リアルタイム更新

設定

無料の MongoDB Atlas クラスターのセットアップ（クイックスタート）

MongoDB インスタンスをまだ実行していない場合は、MongoDB Atlas（https://cloud.mongodb.com）で無料のクラウドクラスターを数分で起動できます。

1. 登録／サインイン
   https://cloud.mongodb.com を開いてアカウントを作成します。メールアドレスで登録するか、Google または GitHub でサインインできます。

2. プロジェクトとクラスターを作成
   新しい Project（例：mcp-memory）を作成し、Create → Deployment → Create a cluster を選択します。 Free Shared (M0) ティアを選び、お使いの環境に最も近いプロバイダー／リージョンを選択して、クラスターに名前を付け、Create をクリックします。 プロビジョニングには約 2～3 分かかります。

3. データベースユーザーを作成
   Database Access → Add New Database User に移動します。 – Password 認証を選択します。 – Username（例：mcp_user）と強力な Password（または自動生成したパスワード）を入力します。 – クイックテストでは、ユーザーに Read and write to any database 権限を付与します（後から制限できます）。 – Add User をクリックし、認証情報を安全な場所に保存します。

4. IP アドレスを許可
   Network Access → Add IP Address に移動し、サーバーが接続するパブリック IP アドレスを許可リストに追加します。 Add Current IP Address をクリックするか、手動で指定できます。

5. 接続文字列（URI）を取得
   Database Deployments 画面で Connect → Drivers をクリックし、Python を選択して、次のような URI をコピーします。

   mongodb+srv://<username>:<password>@<cluster>.mongodb.net/?retryWrites=true&w=majority
   

   <username>／<password> を手順 3 で設定した認証情報に置き換え、必要に応じて /<database> を追加してデフォルトのデータベースを選択します。例：/mcp_memory。

6. Memory Graph Server を設定
   サーバーが想定する環境変数を使って接続文字列をエクスポートします。

   export MCP_MONGO_MEMORY_CONNECTION="mongodb+srv://mcp_user:<password>@cluster0.mongodb.net/mcp_memory?retryWrites=true&w=majority"
   

   特殊文字が保持されるように URI を引用符で囲み、この文字列をバージョン管理に絶対にコミットしないでください。

これで、MCP Server Configuration セクションの手順に従ってサーバーを起動できます。

環境変数を直接使用する

または、必要な環境変数を直接設定できます。

MCP_MONGO_MEMORY_CONNECTION=mongodb://username:password@host:port/database

インストールとセットアップ

前提条件

1. uvx をインストールします（まだインストールしていない場合）。

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. MongoDB 接続を設定します（下記の「設定」セクションを参照）。

MCP サーバーの設定

以下のスニペットを mcp 設定に追加します。

{
  "mcpServers": {
    "Memory": {
      "command": "/path/to/local/bin/uvx",
      "args": [
        "mongo-memory"
      ],
      "env": {
        "MCP_MONGO_MEMORY_CONNECTION": "mongodb://username:password@host:port/database"
      }
    }
  }
}

/path/to/local/bin/ を uvx の実際のパスに置き換えてください。 接続文字列を実際の MongoDB 認証情報に置き換えてください。

利用可能な操作

サーバーは、AI エージェント向けに以下の操作を提供します。

エンティティ管理：

• create_entities - 一意の名前で新しいエンティティを作成します
• get_entity - 名前を指定して単一のエンティティを取得します
• update_entity - 既存のエンティティデータを更新します
• delete_entity - エンティティを削除します
• find_entities - クエリ条件でエンティティを検索します

リレーションシップ管理：

• create_relationship - エンティティ間のリレーションシップを作成します
• get_relationships - フィルタリングしてリレーションシップを取得します
• delete_relationship - 特定のリレーションシップを削除します

メモリ構造：

• get_memory_structure - 現在のメモリ構成を取得します
• get_usage_guide - 包括的な使用例とベストプラクティスを取得します

詳しい使用例、パターン、ベストプラクティスについては、AI エージェントが get_usage_guide() を呼び出してください。

開発

開発環境のセットアップとガイドラインについては、DEVELOPMENT.md を参照してください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。