安装

使用 Homebrew 快速入门（仅限 Mac）

brew install neo4j-mcp

手动安装服务器

访问 Neo4j MCP 的发布页面：https://github.com/neo4j/mcp/releases

下载适用于您操作系统的压缩包。
解压并将 neo4j-mcp 放置在 PATH 环境变量所包含的目录中。

Mac 和 Linux

chmod +x neo4j-mcp
sudo mv neo4j-mcp /usr/local/bin/

Windows（PowerShell 或 cmd）

move neo4j-mcp.exe C:\Windows\System32

验证 neo4j-mcp 安装

neo4j-mcp -v

这应该会显示已安装的版本。

配置 VSCode（MCP）

创建 / 编辑 mcp.json

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "neo4j-mcp",
      "env": {
        "NEO4J_URI": "bolt://:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true"
      }
    }
  }
}

在 env 对象中设置如上所示的环境变量。

或者，您可以在 args 数组中使用命令行标志来覆盖环境变量

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "neo4j-mcp",
      "args": [
        "--neo4j-uri", "bolt://:7687",
        "--neo4j-username", "neo4j",
        "--neo4j-password", "password",
        "--neo4j-database", "neo4j"
      ],
      "env": {
        "NEO4J_READ_ONLY": "true"
      }
    }
  }
}

HTTP 模式配置（VSCode）

在 HTTP 模式下，您可以使用基本身份验证或 Bearer Token（持有令牌）进行配置。

选项 1：基本身份验证

{
  "servers": {
    "neo4j-http": {
      "type": "http",
      "url": "http://127.0.0.1:80/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

生成 Base64 编码的凭据

echo -n "neo4j:password" | base64

选项 2：Bearer Token（企业版 / Aura，带 SSO）

针对已配置 SSO/OAuth 的 Neo4j Enterprise 或 Aura

{
  "servers": {
    "neo4j-http-bearer": {
      "type": "http",
      "url": "http://127.0.0.1:80/mcp",
      "headers": {
        "Authorization": "Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
      }
    }
  }
}

用您身份提供商的实际 OAuth/SSO 令牌替换此 Bearer Token。

有关 HTTP 模式配置、TLS/HTTPS 设置以及传输模式的详细文档，请参见 Transport modes、Configuration 和 TLS/HTTPS Setup 部分。

重新启动 VSCode。打开 Copilot Chat，确保提示 “List Neo4j MCP tools” 返回预期结果。

另请参考 VSCode Copilot 文档。

配置 Claude 桌面版

安装 Claude 桌面版。

为您想要使用的所有 MCP 服务器配置 Claude 桌面版。打开 Claude 桌面版应用的配置文件（使用文本编辑器）。文件位于

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

如果文件不存在，请确保创建它。

在 mcpServers 键中添加 neo4j-mcp MCP

{
  "mcpServers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "neo4j-mcp",
      "args": [],
      "env": {
        "NEO4J_URI": "bolt://:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true"
      }
    }
  }
}