日志

neo4j-mcp 实现了一个结构化日志系统，使用 MCP 规范中定义的日志级别。可以通过环境变量配置日志，以控制详细程度和输出格式。

日志级别

以下日志级别受 MCP 规范支持（按从最详尽到最简略的顺序）

  • debug - 详细的诊断信息

  • info - 一般信息性消息（默认）

  • notice - 正常但重要的事件

  • warning - 警告信息

  • error - 错误信息

  • critical - 关键情况

  • alert - 必须立即采取行动

  • emergency - 系统不可用

使用 NEO4J_LOG_LEVEL 环境变量设置日志级别。日志级别在启动时设定，并在服务器进程的整个生命周期内保持不变。

日志格式

提供两种输出格式

  • text (default) - 人类可读的文本格式

  • json - 用于日志解析和分析的结构化 JSON 格式

使用 NEO4J_LOG_FORMAT 环境变量设置日志格式。

安全特性

日志系统会自动清除包括以下内容的敏感信息

  • 密码

  • 身份验证令牌

  • 连接凭证

这确保敏感数据不会泄露到日志文件中。

配置示例

启用文本输出的调试日志

{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "neo4j-mcp",
      "env": {
        "NEO4J_URI": "bolt://:7687",
        "NEO4J_LOG_LEVEL": "debug",
        "NEO4J_LOG_FORMAT": "text"
      }
    }
  }
}

启用 JSON 日志以便自动解析

{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "neo4j-mcp",
      "env": {
        "NEO4J_URI": "bolt://:7687",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "json"
      }
    }
  }
}