使用说明

项目简介

Memgraph MCP 服务器是一个桥梁，它使得大型语言模型（LLM）客户端能够与 Memgraph 图数据库进行交互。通过实现 Model Context Protocol (MCP)，该服务器允许 LLM 客户端以标准化的方式请求和使用 Memgraph 的数据和功能，从而扩展 LLM 的上下文理解和问题解决能力。

主要功能点

执行 Cypher 查询 (run_query): 允许 LLM 客户端向 Memgraph 数据库发送 Cypher 查询并获取结果。这使得 LLM 能够利用图数据库中存储的知识进行推理和分析。
获取数据库 Schema 信息 (get_schema): 提供检索 Memgraph 数据库 Schema 信息的功能，帮助 LLM 理解数据库的结构和内容，从而更有效地构建查询。

安装步骤

安装 'uv' 和创建虚拟环境: 按照 uv 官方文档安装 'uv'。安装完成后，使用 'uv venv' 命令创建虚拟环境，并使用 '.venv\Scripts\activate' (Windows) 或 'source .venv/bin/activate' (MacOS/Linux) 激活虚拟环境。
安装依赖: 在虚拟环境中运行 'uv add "mcp[cli]" httpx' 命令安装 Memgraph MCP 服务器所需的依赖库。
运行 Memgraph MCP 服务器: 在项目根目录下，执行 'uv run server.py' 命令启动服务器。确保 Memgraph 数据库已启动并可连接。

服务器配置

要将 Memgraph MCP 服务器添加到 MCP 客户端（例如 Claude for Desktop），您需要配置客户端的配置文件。以下是配置示例，您需要根据您的实际环境进行调整。

配置示例 (JSON 格式):

{
    "mcpServers": {
      "mpc-memgraph": {
        "command": "/path/to/your/uv",  //  请替换为 uv 可执行文件的完整路径 (例如: /Users/yourname/.local/bin/uv 或 C:\Users\YourUsername\.local\bin\uv)
        "args": [
            "--directory",
            "/path/to/mcp-memgraph",  // 请替换为 mcp-memgraph 仓库的绝对路径 (例如: /Users/yourname/projects/mcp-memgraph 或 C:\Users\YourUsername\Documents\mcp-memgraph)
            "run",
            "server.py"
        ]
     }
   }
}

配置参数说明:

'"mpc-memgraph"': 服务器名称，您可以自定义，客户端会使用此名称来标识和连接到服务器。
'"command"': 启动服务器的命令。这里需要填写 'uv' 可执行文件的完整路径。您可以使用 'which uv' (MacOS/Linux) 或 'where uv' (Windows) 命令查找 'uv' 的路径。
'"args"': 启动服务器命令的参数列表。
- '"--directory"': 指定服务器代码所在的目录，这里需要填写 mcp-memgraph 仓库的绝对路径。
- '"run"': 'uv run' 命令用于运行 Python 脚本。
- '"server.py"': 指定要运行的服务器脚本文件。

Claude for Desktop 客户端配置:

根据您的操作系统，打开 Claude for Desktop 的配置文件 'claude_desktop_config.json'：

MacOS/Linux: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '$env:AppData\Claude\claude_desktop_config.json'

将上面的 JSON 配置示例添加到 'mcpServers' 字段中。如果 'mcpServers' 字段不存在，请创建它。

基本使用方法

确保 Memgraph MCP 服务器已成功启动，并且 Claude for Desktop 客户端已配置并连接到该服务器。
打开 Claude Desktop 客户端，您应该能在工具列表中看到名为 "mpc-memgraph" 的工具 (服务器名称)。
选择 "mpc-memgraph" 工具，即可在 Claude 中使用 'run_query' 和 'get_schema' 功能与 Memgraph 数据库进行交互。例如，您可以指示 Claude 使用 'run_query' 工具执行 Cypher 查询来检索信息，或使用 'get_schema' 工具获取数据库结构信息。

注意: 使用 'run_query' 工具前，请确保 Memgraph 数据库中已加载数据。'get_schema' 功能可能需要在 Memgraph 服务器端启用 Schema 信息功能 (通过 '--schema-info-enabled=true' 参数启动 Memgraph)。

关键词