使用说明

项目简介

mcp-neo4j-shan 仓库实现了一个先进的知识图谱内存系统，作为 MCP 服务器运行，旨在增强大型语言模型（LLMs）的认知能力。该服务器使用 Neo4j 图数据库来存储具有丰富语义结构的互连信息，并提供了一套工具和检索方法，模拟人类记忆的认知过程。

主要功能点

资源 (Resources) 管理: 使用 Neo4j 知识图谱托管和管理结构化的语义知识资源，支持包括实体、事件、概念等十三种专业节点类型。
工具 (Tools) 提供: 内置多种知识图谱探索和知识创建工具，例如 'explore_weighted_context' 用于加权上下文探索，'create_nodes' 和 'create_relations' 用于知识图谱的构建。
Prompt 模板 (Prompts) 支持: 虽然仓库描述中没有明确提及 Prompt 模板，但其提供的知识图谱和工具旨在作为 LLM 的上下文服务，可以与 Prompt 模板结合使用，以实现更丰富的 LLM 交互模式。
认知启发式检索: 实现了受认知科学启发的检索方法，如 Spreading Activation Retrieval，更有效地从知识图谱中检索相关信息。
客户端工具: 仓库不仅包含服务器，还提供了 'knowledge-processor' 客户端工具，用于从文本语料库中提取知识并导入到 Neo4j 知识图谱，方便用户构建知识库。

安装步骤

环境准备:
- 确保已安装 Node.js (v18+) 和 npm (v9+)。
- 安装 Neo4j 数据库，可以是本地实例或云服务。
- 安装 Python 3.8+，用于 'knowledge-processor' 客户端。

构建 MCP 服务器:

# 克隆仓库
git clone https://github.com/shuruheel/mcp-neo4j-shan.git
cd mcp-neo4j-shan

# 安装依赖
npm install

# 构建 mcp-neo4j-shan 服务器
npx nx build mcp-neo4j-shan

配置 Knowledge Processor 客户端 (可选):

cd clients/knowledge-processor
pip install -r requirements.txt
cp .env.example .env
# 修改 .env 文件，配置 Neo4j 和 OpenAI API 密钥

服务器配置

为了让 MCP 客户端（如 Claude Desktop）连接到 'mcp-neo4j-shan' 服务器，需要在客户端的配置文件中添加服务器配置。以 Claude Desktop 为例，在 'claude_desktop_config.json' 文件中 'mcpServers' 部分添加如下配置：

{
  "mcpServers": {
    "mcp-neo4j-shan": {
      "command": "node",
      "args": [
        "/path/to/mcp-neo4j-shan/dist/servers/mcp-neo4j-shan/main/index.js"
      ],
      "env": {
        "NEO4J_URI": "your-neo4j-instance-uri",
        "NEO4J_USERNAME": "your-neo4j-username",
        "NEO4J_PASSWORD": "your-neo4j-password"
      }
    }
  }
}

参数注释:

'/path/to/mcp-neo4j-shan': 请替换为 'mcp-neo4j-shan' 仓库在您本地文件系统中的绝对路径。
'NEO4J_URI', 'NEO4J_USERNAME', 'NEO4J_PASSWORD': 请替换为您的 Neo4j 数据库连接信息。

基本使用方法

启动 MCP 服务器:

npx nx serve mcp-neo4j-shan

配置 MCP 客户端:
- 按照客户端（例如 Claude Desktop）的文档，配置连接到 'mcp-neo4j-shan' 服务器。

与 LLM 客户端交互:

在 LLM 客户端中，使用 '/mcp mcp-neo4j-shan' 命令，后跟查询语句，即可与 MCP 服务器进行交互，查询知识图谱或调用工具。例如，在 Claude Desktop 中：

/mcp mcp-neo4j-shan explore_weighted_context -n Entity:人物名称 -c Concept:概念名称

请参考仓库 README 文档了解更多工具和使用细节。

关键词