Neo4j Knowledge Graph

🚀 MCP Neo4j メモリサーバー

MCP Neo4j メモリサーバーは、Neo4j グラフデータベースに基づく知識グラフの保存と検索ツールです。Model Context Protocol (MCP) 用に設計されたメモリ強化機能を備えています。このサーバーは、エンティティの作成、関係の構築、および観察情報の保存を処理し、複雑なグラフデータのクエリをサポートします。

✨ 主な機能

• 知識グラフの保存：エンティティとその関係を Neo4j グラフデータベースに効率的に保存します。
• 複雑なクエリ能力：Cypher クエリ言語を利用して、効率的なグラフトラバーサルとパターンマッチングを行います。
• 曖昧検索：Fuse.js と Neo4j の全文インデックスを組み合わせて、柔軟なエンティティ検索機能を提供します。
• 拡張性：クラスターデプロイをサポートし、大規模な知識グラフを処理できます。

📦 インストール

npm を通じてインストールします。

npm install @jovanhsu/mcp-neo4j-memory-server

💻 使用例

基本的な使用法

エンティティとその関係を作成する例です。

import { McpClient } from '@modelcontextprotocol/sdk/client/mcp.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

// 创建客户端运输
const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', '@jovanhsu/mcp-neo4j-memory-server'],
  env: {
    NEO4J_URI: 'bolt://localhost:7687',
    NEO4J_USER: 'neo4j',
    NEO4J_PASSWORD: 'password'
  }
});

const client = new McpClient();
await client.connect(transport);

// 创建实体
const createResult = await client.callTool('create_entities', {
  entities: [
    {
      name: '李明',
      entityType: '人物',
      observations: ['喜欢编程', '使用TypeScript']
    },
    {
      name: 'Google',
      entityType: '公司',
      observations: ['总部位于美国', '业务范围包括搜索、云计算等']
    }
  ]
});

console.log('创建实体结果:', createResult);

// 建立关系
const relationResult = await client.callTool('create_relation', {
  sourceEntityName: '李明',
  targetEntityName: 'Google',
  relationType: '工作于'
});

console.log('建立关系结果:', relationResult);

🔧 技術詳細

データモデル

知識グラフが Neo4j で保存されるモデルは次の通りです。

(Entity:EntityType {name: "实体名称"}) 创建不同类型的实体。
(Entity)-[:HAS_OBSERVATION]->(Observation {content: "观察内容}) 存储与实体相关的观察信息。
(Entity1)-[:RELATION_TYPE]->(Entity2) 建立实体间的复杂关系。

曖昧検索の実装

Neo4j の全文インデックスと Fuse.js を組み合わせて曖昧マッチングを行います。

• Neo4j の全文インデックスを使用して初期検索を行います。
• Fuse.js を通じて追加の曖昧マッチング能力を提供します。
• 検索結果には、完全一致と部分一致が含まれ、関連性でソートされます。

🛠️ 開発

環境設定

# 克隆仓库
git clone https://github.com/JovanHsu/mcp-neo4j-memory-server.git
cd mcp-neo4j-memory-server

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 开发模式（使用 MCP Inspector）
pnpm dev

テスト

# 运行测试
pnpm test

なぜ Neo4j を選んだのか？

元のバージョンで使用されていた JSON ファイル保存や DuckDB バージョンと比較して、Neo4j には以下の利点があります。

1. ネイティブグラフデータベース：Neo4j はグラフデータ用に設計されたデータベースで、知識グラフの保存とクエリに非常に適しています。
2. 高性能クエリ：Cypher クエリ言語を使用することで、複雑なグラフトラバーサルとパターンマッチングを効率的に行うことができます。
3. 関係優先：Neo4j は関係を第一級オブジェクトとして扱うため、エンティティ間の関係クエリがより効率的です。
4. 可視化能力：Neo4j は組み込みの可視化ツールを提供し、デバッグや知識グラフの理解を容易にします。
5. 拡張性：クラスターデプロイをサポートし、大規模な知識グラフを処理できます。

📄 ライセンス

このプロジェクトは MIT ライセンスを採用しています。詳細は LICENSE ファイルを参照してください。

🔗 コンタクト

• GitHub: https://github.com/JovanHsu/mcp-neo4j-memory-server
• NPM: https://www.npmjs.com/package/@jovanhsu/mcp-neo4j-memory-server