🚀 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