Ninjaone MCP

NinjaOne MCP服务器

一种用于与NinjaOne交互的模型上下文协议（MCP）服务器，具有高效工具加载的决策树架构。

一键部署



建筑

此MCP服务器使用 分层工具加载方法 与其预先公开所有工具：

1. 导航阶段：最初只公开一个导航工具(ninjaone_navigate)
2. 域选择：用户选择域（设备、组织、警报、票证）
3. 域名工具：服务器在选择后公开特定于域的工具
4. 懒加载：域处理程序和NinjaOne客户端按需加载

该架构提供：

• 减少认知负荷（可供选择的工具更少）
• 更快的初始加载时间
• 更好地组织相关业务
• 清除导航状态

安装

npm install @wyre-technology/ninjaone-mcp

配置

设置以下环境变量：

NinjaOne API地区

用法

独立运行

# Set credentials
export NINJAONE_CLIENT_ID="your-client-id"
export NINJAONE_CLIENT_SECRET="your-client-secret"
export NINJAONE_REGION="us"

# Run the server
npx @wyre-technology/ninjaone-mcp

Claude桌面配置

添加到您的Claude桌面 claude_desktop_config.json:

{
  "mcpServers": {
    "ninjaone": {
      "command": "npx",
      "args": ["@wyre-technology/ninjaone-mcp"],
      "env": {
        "NINJAONE_CLIENT_ID": "your-client-id",
        "NINJAONE_CLIENT_SECRET": "your-client-secret",
        "NINJAONE_REGION": "us"
      }
    }
  }
}

码头工人

docker build -t ninjaone-mcp .
docker run -e NINJAONE_CLIENT_ID=xxx -e NINJAONE_CLIENT_SECRET=xxx -e NINJAONE_REGION=us ninjaone-mcp

可用域名

设备

管理端点、重新启动设备、查看服务和警报。

工具：

• ninjaone_devices_list -列出带有过滤器的设备
• ninjaone_devices_get -获取设备详细信息
• ninjaone_devices_reboot -安排设备重新启动
• ninjaone_devices_services -列出设备上的Windows服务
• ninjaone_devices_alerts -获取特定于设备的警报
• ninjaone_devices_activities -查看设备活动日志

组织

管理客户组织及其资源。

工具：

• ninjaone_organizations_list -列出组织
• ninjaone_organizations_get -获取组织详细信息
• ninjaone_organizations_create -创建新组织
• ninjaone_organizations_locations -列出组织位置
• ninjaone_organizations_devices -列出组织的设备

警报

查看和管理所有设备上的警报。

工具：

• ninjaone_alerts_list -使用筛选器列出警报
• ninjaone_alerts_reset -重置/解除单个警报
• ninjaone_alerts_reset_all -重置设备或组织的所有警报
• ninjaone_alerts_summary -获取警报计数摘要

门票

管理服务票。

工具：

• ninjaone_tickets_list -列出带过滤器的门票
• ninjaone_tickets_get -获取门票详细信息
• ninjaone_tickets_create -创建新票证
• ninjaone_tickets_update -更新现有工单
• ninjaone_tickets_add_comment -在工单上添加评论
• ninjaone_tickets_comments -获取门票评论

导航工具

始终可用：

• ninjaone_navigate -选择要使用的域
• ninjaone_status -显示当前状态和凭据状态
• ninjaone_back -返回主菜单（在域中时）

工作流示例

User: Check my devices
Claude: [calls ninjaone_navigate with domain="devices"]
       -> Navigated to devices domain. Available tools: ...

User: List all Windows servers
Claude: [calls ninjaone_devices_list with device_class="WINDOWS_SERVER"]
       -> [device list results]

User: Now show me alerts
Claude: [calls ninjaone_back]
       -> Navigated back to main menu.
       [calls ninjaone_navigate with domain="alerts"]
       -> Navigated to alerts domain.

认证

NinjaOne使用OAuth 2.0进行身份验证。您需要：

1. 登录您的NinjaOne仪表板
2. 前往“管理”>“应用程序”>“API”
3. 创建新的API应用程序
4. 注意客户端ID和客户端密码
5. 配置环境变量

客户端库自动处理令牌刷新。

许可证

阿帕奇-2.0