🚀 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;
🤝 贡献指南
欢迎贡献代码、报告问题或提出改进建议！请遵循以下步骤：
- Fork 本仓库。
- 创建您的特性分支 (
git checkout -b feature/amazing-feature)。 - 提交您的更改 (
git commit -m 'Add some amazing feature')。 - 推送到分支 (
git push origin feature/amazing-feature)。 - 创建一个 Pull Request。
🔗 相关项目
📄 许可证
本项目采用 MIT 许可证 - 详见LICENSE文件。