Neo4j Knowledge Graph

🚀 MCP Neo4j 記憶體服務器

MCP Neo4j 記憶體服務器是一款基於 Neo4j 圖數據庫的知識圖譜存儲與檢索工具，專為 Model Context Protocol (MCP) 設計了記憶增強功能。它能夠處理實體創建、關係建立以及觀察信息的存儲，還支持複雜的圖數據查詢，為知識圖譜的管理提供了高效的解決方案。

🚀 快速開始

MCP Neo4j 記憶體服務器是基於 Neo4j 圖數據庫的工具，為 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