MCP Ninjaone

mcp忍者

A. 模型上下文协议（MCP） 服务器 NinjaOne （前身为NinjaRMM），通过NinjaOne REST API v2为人工智能助手提供远程监控和管理的完全访问权限。

特性

19工具 分为五类：

设备管理

组织

警报和条件

维护窗口

工作与自动化

安装

git clone git@github.com:fredriksknese/mcp-ninjaone.git
cd mcp-ninjaone
npm install
npm run build

配置

服务器是通过环境变量配置的：

实例主机名

正在创建API凭据

1. 登录您的NinjaOne实例
2. 导航至 管理>应用程序>API
3. 点击 添加 创建新的API应用程序
4. 选择 客户端凭据 作为授权流程
5. 授予所需的范围： monitoring, management, control, offline_access
6. 复制 客户端ID 和 客户端密钥

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ninjaone": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-ninjaone/dist/index.js"],
      "env": {
        "NINJAONE_CLIENT_ID": "your-client-id",
        "NINJAONE_CLIENT_SECRET": "your-client-secret",
        "NINJAONE_INSTANCE": "app.ninjarmm.com"
      }
    }
  }
}

使用Claude代码

添加到您的Claude Code MCP设置中：

claude mcp add ninjaone -- node /absolute/path/to/mcp-ninjaone/dist/index.js

在运行之前设置所需的环境变量，或在MCP设置中配置它们。

示例提示

连接后，您可以向您的AI助手询问以下问题：

• *“显示当前脱机的所有设备”*
• *“我们在所有组织中都有哪些活动警报？”*
• *“在接下来的2小时内将设备1234置于维护模式”*
• *“列出Acme Corp组织的所有设备”*
• *“设备5678上安装了什么软件？”*
• *“显示设备1234的最近活动”*
• *“在设备9012上运行清理脚本”*
• *“当前在所有设备上运行的作业是什么？”*
• *“重置设备1234的所有次要警报”*
• *“设备5678上有哪些待处理的补丁？”*

发展

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

建筑

src/
├── index.ts                # Entry point — creates MCP server + STDIO transport
├── ninjaone-client.ts      # HTTP client with OAuth2 client credentials flow
└── tools/
    ├── devices.ts          # Device management and inventory (7 tools)
    ├── organizations.ts    # Organization/client management (5 tools)
    ├── alerts.ts           # Alert monitoring and acknowledgement (4 tools)
    ├── maintenance.ts      # Maintenance window management (3 tools)
    └── jobs.ts             # Job execution and monitoring (3 tools)

客户端自动处理OAuth2令牌生命周期——令牌在首次使用时提取，并在到期时（通常在1小时后）刷新。

需求

• Node.js 18+
• 已启用API访问的NinjaOne帐户

许可证

见许可证文件