🚀 mcp-server-ntopng

mcp-server-ntopng 是一个 模型上下文协议 服务器实现，用于与 NTOPNG 对接，允许 AI 模型通过上下文进行交互，解决了 AI 模型与 NTOPNG 之间的数据交互问题，为数据分析等场景提供了支持。

🚀 快速开始

环境变量配置

以下环境变量用于配置数据库连接：

• NTOPNG_HOST：NTOPNG 服务的主机名。
• NTOPNG_DBUSER：ClickHouse 数据库的身份验证用户名。
• NTOPNG_DBPASSWORD：ClickHouse 数据库的身份验证密码。
• NTOPNG_API_KEY：NTOPNG 的身份验证令牌。

可选配置

• NTOPNG_DBPORT：ClickHouse 数据库的端口号，默认值根据 HTTPS 是否启用而定（HTTPS 启用默认为 9000，未启用默认为 8123）。
• NTOPNG_SECURE：启用/禁用 TLS 连接，默认为 false。
• NTOPNG_VERIFY：启用/禁用 SSL 证书验证，默认为 true。
• NTOPNG_CONNECT_TIMEOUT：连接超时时间（秒），默认为 30 秒。
• NTOPNG_SEND_RECEIVE_TIMEOUT：发送/接收超时时间（秒），默认为 300 秒。

安装与运行

1. 安装依赖：

$ uv sync

2. 安装包：

$ uv pip install -e .

3. 启动服务器（使用示例环境变量）：

$ CLIENT_PORT=8077 SERVER_PORT=8078  mcp dev run_mcp_ntopng.py --with clickhouse-driver --with python-dotenv --with uvicorn --with pip-system-certs

在 Claude Desktop 中使用

编辑路径：/Users/marco/Library/Application\ Support/Claude/claude_desktop_config.json

修改 claude_desktop_config.json 文件，将本地路径替换为以下内容：

{
    "mcpServers": {
      "mcp-ntopng": {
        "command": "/Users/marco/Development/claude/mcp-server-ntopng/.venv/bin/python",
        "args": [
           "/Users/marco/Development/claude/mcp-server-ntopng/run_mcp_ntopng.py"
        ],
        "env": {
          "NTOPNG_HOST": "marcoeg-nod004.ntoplink.com",
          "NTOPNG_DBPORT": "9000",
          "NTOPNG_DBUSER": "default",
          "NTOPNG_DBPASSWORD": "",
          "NTOPNG_SECURE": "false",
          "NTOPNG_VERIFY": "false",
          "SELECT_QUERY_TIMEOUT_SECS": "30",
          "NTOPNG_API_KEY": "NTOPNG_TOKEN"
        }
      }
    }
  }

⚠️ 重要提示

请根据实际情况调整上述配置中的路径和值。

✨ 主要特性

• 支持多种查询类型：包括实时数据、历史数据分析等。
• 高效的通信机制：确保模型与 NTOPNG 之间的高效数据交换。
• 灵活的配置选项：支持自定义环境变量来调整服务器行为。