🚀 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 秒。
安装与运行
- 安装依赖：
$ uv sync
- 安装包：
$ uv pip install -e .
- 启动服务器（使用示例环境变量）：
$ 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 之间的高效数据交换。
- 灵活的配置选项：支持自定义环境变量来调整服务器行为。