Knowledge Graph

🚀 知識グラフメモリサーバー

知識グラフメモリサーバーは、知識グラフデータを管理および保存するためのツールです。これにより、Claudeなどのモデルがユーザーとの対話情報をより良く理解し、記憶することができます。本ドキュメントでは、このサーバーの機能、使用方法、および関連する設定について詳しく説明します。

✨ 主な機能

🔧 コアコンセプト

エンティティ（Entities）

エンティティは知識グラフの基本単位で、独立した存在を持つ人、物、または概念を表します。各エンティティには以下の属性が含まれます。

• 識別子：エンティティを一意に識別する文字列。
• タイプ：エンティティが属するカテゴリを表すラベル（例：「人」、「組織」、「場所」など）。
• 属性：エンティティの特徴を記述する情報（例：年齢、性別、職業など）。

関係（Relations）

関係は、2つ以上のエンティティ間の関連を表します。例えば：

{
  "subject": "张三",
  "predicate": "工作于",
  "object": "谷歌公司"
}

観測結果（Observations）

観測結果はエンティティの特徴の記録で、通常はタイムスタンプをインデックスとして保存されます。例えば：

{
  "entity_id": "12345",
  "timestamp": "2023-10-01T12:00:00Z",
  "facts": [
    {
      "key": "年龄",
      "value": "30"
    },
    {
      "key": "职业",
      "value": "软件工程师"
    }
  ]
}

📄 APIインターフェース

エンティティの作成（Create Entities）

POST /entities
{
  "entities": [
    {
      "id": "12345",
      "type": "人",
      "attributes": {
        "name": "张三",
        "age": "30"
      }
    },
    {
      "id": "67890",
      "type": "公司",
      "attributes": {
        "name": "谷歌公司",
        "location": "美国"
      }
    }
  ]
}

関係の作成（Create Relations）

POST /relations
{
  "relation": {
    "subject": "张三",
    "predicate": "工作于",
    "object": "谷歌公司"
  }
}

📦 インストール

設定ファイルの設定

mcp.jsonまたはclaude_desktop_config.jsonに以下の設定を追加します。

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@itseasy21/mcp-knowledge-graph"
      ],
      "env": {
        "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
      }
    }
  }
}

Smitheryを使用したインストール

Smitheryプラットフォームを通じて自動インストールします。

npx -y @smithery/cli install @itseasy21/mcp-knowledge-graph --client claude

💻 使用例

カスタムメモリパスの指定

カスタムメモリファイルのパスは以下の2つの方法で指定できます。

コマンドライン引数

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@itseasy21/mcp-knowledge-graph", "--memory-path", "/path/to/your/memory.jsonl"]
    }
  }
}

環境変数

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@itseasy21/mcp-knowledge-graph"],
      "env": {
        "MEMORY_FILE_PATH": "/path/to/your/memory.jsonl"
      }
    }
  }
}

パスが指定されない場合、デフォルトでmemory.jsonlファイルが使用されます。

システムプロンプトの設定

具体的なアプリケーションシナリオに応じて、以下のシステムプロンプトを調整して、モデルがメモリを管理する方法を指示することができます。

作为记忆顾问，请协助我更好地管理和存储与用户相关的交互信息。

以上の設定とインターフェースを通じて、知識グラフメモリサーバーはモデルがユーザー情報をより効率的に理解し、記憶するのを支援し、人間と機械の対話体験を向上させます。