Opennms MCP

opennms-mcp

一 MCP（模型上下文协议） 将Claude连接到OpenNMS的服务器。让Claude列出警报、检查节点、发送事件、更新资产记录、管理类别和控制服务收集——所有这些都是用简单的语言完成的。

先决条件

• Node.js 22+
• 可通过HTTP/HTTPS访问的OpenNMS实例
• 具有API访问权限的用户帐户（管理员或读/写角色）

安装

git clone https://github.com/c-perronnet/opennms-mcp.git
cd opennms-mcp
npm install
npm run build

配置

使用您的OpenNMS凭据创建一个JSON文件。支持两种身份验证格式：

基本认证 (opennms/myserver.json):

{
  "url": "https://opennms.example.com",
  "username": "admin",
  "password": "secret"
}

令牌身份验证 (opennms/myserver.json):

{
  "url": "https://opennms.example.com",
  "token": "your-api-token"
}

添加 "insecure": true 选择任一格式以跳过TLS证书验证（对自签名证书有用）。

将配置文件存储在 opennms/ directory——它被git忽略，因此永远不会提交凭据。

连接到克劳德桌面

将服务器添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "opennms": {
      "command": "node",
      "args": ["/absolute/path/to/opennms-mcp/dist/index.js"],
      "env": {
        "OPENNMS_CONFIG": "/absolute/path/to/opennms-mcp/opennms/myserver.json"
      }
    }
  }
}

或者，将配置路径作为位置参数传递：

{
  "mcpServers": {
    "opennms": {
      "command": "node",
      "args": [
        "/absolute/path/to/opennms-mcp/dist/index.js",
        "/absolute/path/to/opennms-mcp/opennms/myserver.json"
      ]
    }
  }
}

连接到克劳德代码

Claude Code从读取MCP服务器配置 ~/.claude/claude_mcp_settings.json。在那里添加服务器：

{
  "mcpServers": {
    "opennms": {
      "command": "node",
      "args": ["/absolute/path/to/opennms-mcp/dist/index.js"],
      "env": {
        "OPENNMS_CONFIG": "/absolute/path/to/opennms-mcp/opennms/myserver.json"
      }
    }
  }
}

或者通过CLI进行配置：

claude mcp add opennms \
  -e OPENNMS_CONFIG=/absolute/path/to/opennms-mcp/opennms/myserver.json \
  -- node /absolute/path/to/opennms-mcp/dist/index.js

验证服务器是否已加载 /mcp 在克劳德代码提示中。下面列出的工具将在任何对话中可用。

可用工具

连接性

警报

节点

事件

资产记录

类别

收集/投票

FIQL过滤

几个列表工具接受 filter 参数使用 FIQL 语法：

示例：

• severity==CRITICAL --仅限关键警报
• node.label==web* --标签以“web”开头的节点
• severity==MAJOR,severity==CRITICAL --重大或关键警报
• category.name==Routers --路由器类别中的节点

发展

npm run dev    # watch mode — recompiles on file changes
npm run build  # one-shot compile to dist/
npm start      # run compiled server (requires OPENNMS_CONFIG)

许可证

麻省理工学院