xgmem MCP Memory Server

xgmem MCP メモリーサーバー

xgmem は、Claude、LLM エージェント、その他のツールで、プロジェクト固有のナレッジグラフベースのメモリーを利用できるようにする、TypeScript ベースの Model Context Protocol（MCP）サーバーです。柔軟性とプロジェクト間でのナレッジ共有を重視し、プロジェクトごとにエンティティ、リレーション、観察内容を保存、取得、管理できます。

特長

• エンティティ、リレーション、観察内容をナレッジグラフに保存
• MCP ツールによる CRUD 操作
• ディスクへの永続化（memory.json）
• Docker と TypeScript に対応

ユースケース

xgmem は、次の用途に適しています。

• プロジェクトごとに構造化されたメモリー（エンティティ、リレーション、観察内容）を保存、取得する必要があるエージェントや LLM。
• プロジェクト間でのナレッジ共有と移行。
• エージェントエコシステム向けの、拡張性が高く、ディスクに永続化され、クエリ可能なメモリー。

使用方法

MCP 設定例

MCP 設定に追加します（例：windsurf の場合）。

"mcpServers": {
    "xgmem": {
      "command": "npx",
      "args": ["-y", "xgmem@latest"]
    }
  }

依存関係をインストール

npm install

ビルド

npm run build

実行（開発）

npx ts-node index.ts

実行（本番）

npm start

Docker

docker build -t xgmem-mcp-server .
docker run -v $(pwd)/memories:/app/memories xgmem-mcp-server

これにより、すべてのプロジェクトメモリーファイルがホスト上の memories ディレクトリに永続化されます。

メモリーの保存方法（MCP API）

プロジェクトの観察内容（メモリー）を保存するには、MCP API 経由で save_project_observations ツールを呼び出します。

JSON の例：

{
  "name": "save_project_observations",
  "args": {
    "projectId": "demo-project",
    "observations": [
      {
        "entityName": "Alice",
        "contents": [
          "Alice joined Acme Corp in 2021.",
          "Alice is a software engineer."
        ]
      },
      {
        "entityName": "Bob",
        "contents": [
          "Bob joined Acme Corp in 2022.",
          "Bob is a product manager."
        ]
      }
    ]
  }
}

互換性のある任意の MCP クライアントを使用するか、サーバーを直接実行している場合は、この JSON を標準入力経由で送信できます。

ツールと API

xgmem は、次のツールを公開しています。

• save_project_observations
• get_project_observations
• add_graph_observations
• create_entities
• create_relations
• delete_entities
• delete_observations
• delete_relations
• read_graph
• search_nodes
• search_all_projects
• open_nodes
• copy_memory

MCP API 経由のドキュメントと使用例については、get_help ツール（有効な場合）を参照してください。

設定

• メモリーの保存先ディレクトリを変更するには、MEMORY_DIR_PATH 環境変数を設定します（デフォルト：/app/memories）。

ライセンス

MIT