MCP Memory Server

🚀 MCP Memory Server

Model Context Protocol (MCP) を使用したサーバー実装で、大規模言語モデルに永続的なメモリ機能を提供します。

🚀 クイックスタート

このリポジトリには、Model Context Protocol のメモリサーバーの参照実装が含まれています。このサーバーは、知識グラフベースの永続的なメモリシステムを実装しており、大規模言語モデル（LLM）が会話やセッションを通じて情報を保存、取得、推論できるようにします。

✨ 主な機能

• 知識グラフストレージ：グラフベースの永続的な情報保存
• エンティティ管理：エンティティとその関係の作成と管理
• 意味検索：意味的な類似性を使用して関連情報を検索
• セッション間メモリ：異なる会話間でコンテキストを維持
• メモリ操作：メモリ管理のための完全な CRUD 操作

📦 インストール

npm install
npm run build

💻 使用例

基本的な使用法

# メモリサーバーを起動する
npx mcp-server-memory

高度な使用法

開発モードでの起動

npm run watch

これにより、ファイルの変更があると自動的に再構築される開発モードでサーバーが起動します。

サーバーの直接実行

開発やテストのために、サーバーを直接実行することができます。

# まだビルドされていない場合は先にビルドする
npm run build

# サーバーを実行する
node dist/index.js

npm バイナリの使用

ビルド後、npm バイナリ名を使用することができます。

npx mcp-server-memory

バックグラウンドプロセスとしての実行

サーバーは継続的に実行され、標準入出力（stdio）を介して通信します。これは MCP サーバーの標準です。

📚 ドキュメント

MCP Inspector でのテスト

MCP Inspector は、開発中のメモリサーバーのテストとデバッグに優れたツールです。

Inspector の起動

npx @modelcontextprotocol/inspector node dist/index.js

これにより、以下のことが行われます。

1. プロキシサーバーが起動します（通常は 127.0.0.1:6277）。
2. ウェブベースのインスペクターインターフェイスが起動します（通常は http://127.0.0.1:6274）。
3. 認証用のセッショントークンが提供されます。

Inspector の使用

Inspector は、サーバーをテストするためのいくつかのタブを提供します。

• Resources タブ：メモリリソースを表示してテストする
• Tools タブ：メモリ管理ツール（エンティティの作成、更新、削除）をテストする
• Prompts タブ：任意のプロンプトテンプレートをテストする
• Notifications ペイン：サーバーのログとメッセージを監視する

開発ワークフロー

1. src/index.ts を変更する
2. npm run build を実行して再構築する
3. Inspector を起動する: npx @modelcontextprotocol/inspector node dist/index.js
4. ウェブインターフェイスで変更をテストする
5. エラーがないか Notifications ペインを確認する

MCP クライアントとの統合

このサーバーを MCP クライアント（Claude Desktop など）で使用するには、クライアントの設定に追加します。

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/your/mcp-memory-server/dist/index.js"]
    }
  }
}

または、npm に公開されている場合は、以下のように使用できます。

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-memory"]
    }
  }
}

Model Context Protocol

Model Context Protocol (MCP) は、AI アプリケーションと外部データソースおよびツールとのシームレスな統合を可能にするオープン標準です。詳細は modelcontextprotocol.io を参照してください。

📄 ライセンス

MIT