MCP Server Prtg

MCP服务器PRTG

](https://github.com/senhub-io/mcp-server-prtg/releases)   

MCP服务器PRTG 是一个 模型上下文协议（MCP） 通过标准化API公开PRTG监控数据的服务器。它使LLM（如Claude）能够查询传感器状态、分析警报，并实时生成有关监控基础设施的报告。

先决条件

MCP服务器PRTG 需要访问：

1. PRTG数据导出器 -PostgreSQL数据库(prtg_data_exporter)用于传感器状态和配置
2. PRTG核心服务器 -API v2（可选，用于历史指标和通道数据）

部署选项

选项A：同地办公（推荐）

• 在与PRTG数据导出器相同的Windows服务器上安装MCP服务器PRTG
• 本地PostgreSQL访问的最佳性能
• 无网络延迟

选项B：远程部署

• 在任何服务器（Linux、macOS、Windows）上安装MCP服务器PRTG
• 需要网络访问：

- PostgreSQL数据库（默认端口5432） - PRTG API v2（默认端口1616）

• 相应地配置防火墙规则

注： PRTG数据导出器仅适用于Windows，但MCP服务器PRTG可在任何平台上运行。

特性

• 可流式HTTP传输 -具有HTTP SSE流的现代MCP协议（2025-03-26）
• 15个MCP工具 查询PRTG数据：

- 12工具 PostgreSQL数据库（传感器、警报、层次结构、组、标签、业务流程、统计数据、SQL） - 3工具 对于PRTG API v2（历史指标、时间序列、信道值）

• PRTG API v2集成 -直接从PRTG查询历史指标和实时信道数据
• 承载令牌身份验证 （RFC 6750）
• TLS/HTTPS支持 自动生成证书
• Windows服务 -通过kardianos/service进行安装和管理
• 文件记录 旋转（伐木工人）
• 热重载 配置
• 多平台 -Windows、Linux、macOS

快速安装

视窗

# 1. Download the binary
#    mcp-server-prtg_windows_amd64.exe

# 2. Install as Windows service
.\mcp-server-prtg.exe install

# 3. Start the service
.\mcp-server-prtg.exe start

# 4. Check status
.\mcp-server-prtg.exe status

Linux/macOS

# 1. Download the appropriate binary
#    mcp-server-prtg_linux_amd64
#    mcp-server-prtg_darwin_arm64

# 2. Make it executable
chmod +x mcp-server-prtg

# 3. Install as systemd service (Linux)
sudo ./mcp-server-prtg install

# 4. Start
sudo ./mcp-server-prtg start

# Or run in console (foreground)
./mcp-server-prtg run

配置

首次安装时，a config.yaml 文件是通过以下方式自动生成的：

• 唯一的API键
• 自签名TLS证书
• 默认PostgreSQL配置

地点： ./config.yaml （或通过指定 --config)

最小示例：

version: 1
server:
  api_key: "your-mcp-server-api-key"  # MCP Server authentication key
  bind_address: "0.0.0.0"
  port: 8443
  enable_tls: true
database:
  host: localhost                     # PostgreSQL server (PRTG Data Exporter)
  port: 5432
  name: prtg_data_exporter
  user: prtg_reader
  sslmode: disable
prtg:
  enabled: true                       # Enable PRTG API v2 integration
  base_url: "https://prtg.example.com:1616"  # PRTG Core Server API v2
  api_token: "your-prtg-api-v2-token" # PRTG API v2 Bearer token
  timeout: 30
  verify_ssl: true
logging:
  level: info

PRTG API v2配置（可选）：

启用PRTG API v2以查询历史指标和实时通道数据：

• enabled：启用/禁用PRTG API访问（默认值：false）
• base_url：具有API v2端口的PRTG服务器URL（通常为1616，而不是443）
• api_token：PRTG API v2承载令牌（从PRTG web界面获取）
• timeout：HTTP请求超时（秒）（默认值：30）
• verify_ssl：验证SSL证书（对于自签名证书设置为false）

注： PRTG API v2配置是可选的。如果不配置，则只有基于PostgreSQL的工具可用。

请参阅： docs/CONFIGURATION.md 获取完整的文档

与MCP客户端一起使用

使用配置您的MCP客户端（如Claude Desktop）以连接到MCP服务器PRTG mcp-remote:

{
  "mcpServers": {
    "prtg": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://:8443/mcp",
        "--header",
        "Authorization:Bearer ${MCP_SERVER_API_KEY}"
      ],
      "env": {
        "MCP_SERVER_API_KEY": "your-mcp-server-api-key"
      }
    }
  }
}

重要提示：

• ``：运行MCP服务器PRTG的IP或主机名（不是PRTG核心服务器）
• MCP_SERVER_API_KEY：MCP服务器PRTG的API密钥 config.yaml （不是PRTG API v2令牌）

对于HTTP（仅限开发）：

{
  "mcpServers": {
    "prtg": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://:8443/mcp",
        "--header",
        "Authorization:Bearer ${MCP_SERVER_API_KEY}"
      ],
      "env": {
        "MCP_SERVER_API_KEY": "your-mcp-server-api-key"
      }
    }
  }
}

注： 对于具有自签名证书的生产，请添加 NODE_TLS_REJECT_UNAUTHORIZED=0 到 env （不推荐）或使用受信任的CA证书。

请参阅： docs/USAGE.md 使用示例

可用的MCP工具

基于PostgreSQL的工具（12）

PRTG API v2工具（3）

请参阅： docs/TOOLS.md 获取完整的工具文档

MCP客户端配置

MCP服务器PRTG可与任何兼容MCP的客户端配合使用：

测试和验证：

• 克劳德桌面 ✅ - Anthropic的官方桌面应用程序（经过全面测试）

社区配置 （基于官方规格，尚未测试）：

• Continue.dev ⚠️ - VS代码和JetBrains扩展
• 光标 ⚠️ - AI第一代码编辑器
• 克莱恩 ⚠️ - VS Code的自主编码代理

💡 欢迎反馈！ 如果您测试这些配置，请通过以下方式分享您的经验 .

文档

• 安装指南
• 配置指南
• 使用指南
• MCP工具参考
• 建筑
• 故障排除

从源代码构建

# Clone the repo
git clone https://github.com/senhub-io/mcp-server-prtg.git
cd mcp-server-prtg

# Build for current platform
make build

# Build for all platforms
make build-all

# Build Windows only
make build-windows

# Binaries are in ./build/

实用命令

# Run in console mode (foreground)
./mcp-server-prtg run

# View detailed status (service + database)
./mcp-server-prtg status

# Stop the service
./mcp-server-prtg stop

# Uninstall (with automatic cleanup)
./mcp-server-prtg uninstall

# Show version
./mcp-server-prtg --version

# Help
./mcp-server-prtg --help

故障排除

服务无法启动？

• 检查日志： ./logs/mcp-server-prtg.log
• 检查配置： ./mcp-server-prtg status
• 启用调试： log_level: debug 在config.yaml中

数据库连接失败？

• 验证PostgreSQL是否正在运行
• 检查config.yaml中的凭据
• 对于SSL： sslmode: require （或 disable 用于测试）

请参阅： docs/TROUBLESHOOTING.md

许可证

MIT许可证-请参阅 许可证 详情

贡献

欢迎投稿！请随时打开问题或提交PR。

支持

如有疑问或问题：

• 打开A
• 检查 文档

______________________________________________________________________

组织机构： SenHub.io MCP协议： 模型上下文协议.io