Neo4j Knowledge Graph Memory Server

🚀 MCP Neo 浩客知識グラフストレージサーバー

MCP Neo 浩客知識グラフストレージサーバーは、高性能、拡張性、高信頼性、使いやすさを兼ね備えた知識グラフストレージサーバーです。Neo4jをベースに構築され、MCPプロトコルを通じて知識グラフの操作を行うことができます。

✨ 主な機能

• 高性能：Neo4jのネイティブグラフデータベースを利用し、効率的なグラフデータの保存とクエリ能力を提供します。
• 拡張性：大規模な知識グラフの構築とクエリに対応しています。
• 高信頼性：ACIDトランザクションを使用してデータの一貫性を保証します。
• 使いやすさ：MCPプロトコルインターフェースを通じて、エンティティの作成、関係の接続、観察記録の保存操作を行うことができます。

📦 インストール

インストールコマンド

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

サーバー起動

npx 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', 'mcp-neo4j-memory-server'],
});

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

// 新しいエンティティの作成
const resultCreate = await client.callTool('create_entities', {
  entities: [
    {
      name: '张三',
      entityType: '人物',
      observations: ['喜欢编程', '使用TypeScript']
    },
    {
      name: 'Google',
      entityType: '公司',
      observations: ['总部位于美国加利福尼亚州']
    }
  ]
});

console.log('エンティティ作成結果:', resultCreate);

// 関係の作成
const resultRelation = await client.callTool('create_relationships', {
  relationships: [
    {
      fromEntityId: resultCreate.entities[0].id, // 张三のID
      toEntityId: resultCreate.entities[1].id,   // GoogleのID
      relationType: '工作于'
    }
  ]
});

console.log('関係作成結果:', resultRelation);

🔧 技術詳細

データモデル

Neo4jにおけるデータの保存構造は以下の通りです。

(Entity:EntityType {name: "エンティティ名"})
(Entity)-[:HAS_OBSERVATION]->(Observation {content: "観察内容"})
(Entity1)-[:RELATION_TYPE]->(Entity2)

クエリ例

张三とその関係の検索

MATCH (a:人物 {name: '张三'}) 
OPTIONAL MATCH (a)-[r]->(b) 
RETURN a, r, b;

Googleに関連するすべてのエンティティの検索

MATCH (a)-[:工作于]->(Google:公司 {name: 'Google'})
RETURN a;

🤝 コントリビューションガイド

コードの貢献、問題の報告、改善提案を歓迎します！以下の手順に従ってください。

1. このリポジトリをForkします。
2. 新しい機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Requestを作成します。

📚 関連プロジェクト

• Model Context Protocol
• MCP Inspector

📄 ライセンス

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

📞 連絡先

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