Neo4j Knowledge Graph Memory Server

🚀 MCP Neo 浩客知識圖譜存儲服務器

MCP Neo 浩客知識圖譜存儲服務器基於 Neo4j 原生圖數據庫，為知識圖譜提供高性能、可擴展且可靠的存儲與查詢解決方案。它支持大規模知識圖譜構建，通過 MCP 協議接口實現便捷操作。

🚀 快速開始

安裝

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

啟動

npx mcp-neo4j-memory-server

✨ 主要特性

• 高性能：基於 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