Device42 MCP

🚀 Device42 MCP 服務器

Device42 MCP 服務器是用於 Device42 IT 資產管理的解決方案，採用 Node.js/TypeScript 實現。它能幫助用戶更高效地管理 IT 資產，提供便捷的查詢和操作功能。

✨ 主要特性

• 零安裝：可直接使用 npx device42-mcp 運行。
• 快速：使用原生 fetch（Node 18+），無需沉重的 HTTP 庫。
• 類型安全：完全採用 TypeScript 編寫。
• 依賴極少：僅依賴 @modelcontextprotocol/sdk 和 zod。
• 讀寫模式：設置 D42_READONLY=false 可啟用寫操作。
• DOQL 支持：可使用 Device42 強大的查詢語言執行復雜查詢。

💻 使用示例

示例問題

配置完成後，你可以向 AI 助手提出如下問題：

基礎查詢

• "列出紐約數據中心的所有設備"
• "服務器 web - prod - 01 的 IP 地址是什麼？"
• "顯示所有運行 Ubuntu 的設備"
• "哪些設備在 A - 15 機架中？"
• "查找所有標記為 '生產' 的設備"

網絡與 IP 管理

• "10.0.1.0/24 子網中有哪些可用 IP？"
• "顯示分配給數據庫服務器的所有 IP"
• "列出總部大樓中的所有 VLAN"
• "192.168.1.50 在哪個子網中？"

基礎設施概述

• "提供倫敦數據中心所有機架的摘要"
• "每個操作系統有多少臺設備？"
• "列出所有建築物及其房間數量"
• "我們使用了哪些硬件型號？"

DOQL 查詢（高級）

服務器支持 DOQL（Device42 對象查詢語言），可實現複雜的跨表查詢：

• "運行 DOQL 查詢，查找過去 30 天內添加的、內存超過 64GB 的所有設備"
• "使用 DOQL 生成按部門和服務級別分組的設備報告"
• "查詢所有虛擬機及其主機關係"
• "查找保修在未來 90 天內到期的設備"

AI 可能生成的 DOQL 示例：

SELECT d.name, d.ram, d.first_added 
FROM view_device_v1 d 
WHERE d.ram > 65536 
AND d.first_added > NOW() - INTERVAL '30 days'

🚀 快速開始

無需安裝，只需將其添加到 MCP 客戶端配置中：

Cursor（npx）

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "device42": {
      "command": "npx",
      "args": ["-y", "device42-mcp"],
      "env": {
        "D42_URL": "https://your-device42.com",
        "D42_USERNAME": "api-user",
        "D42_PASSWORD": "api-password",
        "D42_VERIFY_SSL": "true",
        "D42_READONLY": "true"
      }
    }
  }
}

Cursor（Docker）

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "device42": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "D42_URL=https://your-device42.com",
        "-e", "D42_USERNAME=api-user",
        "-e", "D42_PASSWORD=api-password",
        "-e", "D42_VERIFY_SSL=true",
        "-e", "D42_READONLY=true",
        "killcity/device42-mcp:latest"
      ]
    }
  }
}

Claude Desktop（npx）

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "device42": {
      "command": "npx",
      "args": ["-y", "device42-mcp"],
      "env": {
        "D42_URL": "https://your-device42.com",
        "D42_USERNAME": "api-user",
        "D42_PASSWORD": "api-password",
        "D42_VERIFY_SSL": "true",
        "D42_READONLY": "true"
      }
    }
  }
}

Claude Desktop（Docker）

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "device42": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "D42_URL=https://your-device42.com",
        "-e", "D42_USERNAME=api-user",
        "-e", "D42_PASSWORD=api-password",
        "-e", "D42_VERIFY_SSL=true",
        "-e", "D42_READONLY=true",
        "killcity/device42-mcp:latest"
      ]
    }
  }
}

📦 安裝指南

全局安裝

npm install -g device42-mcp
device42-mcp

從源代碼安裝

git clone https://github.com/killcity/device42-mcp.git
cd device42-mcp
npm install
npm run build
node dist/index.js

Docker（獨立運行）

docker pull killcity/device42-mcp:latest

docker run -i --rm \
  -e D42_URL="https://your-device42.com" \
  -e D42_USERNAME="user" \
  -e D42_PASSWORD="pass" \
  -e D42_VERIFY_SSL="true" \
  -e D42_READONLY="true" \
  killcity/device42-mcp:latest

或者本地構建：

docker build -t device42-mcp:latest .

📚 詳細文檔

環境變量

可用工具

讀操作

• list_devices、get_device、get_device_by_name、search_devices
• list_ips、get_ip、search_ips_by_device
• list_subnets、get_subnet
• list_racks、get_rack
• list_rooms、get_room
• list_buildings、get_building
• list_vlans、get_vlan
• list_software、get_software
• list_business_apps、get_business_app
• list_app_components、get_app_component
• list_hardware_models、list_operating_systems、list_vendors
• doql_query - 執行原始 DOQL 查詢以進行復雜數據檢索

寫操作（當 D42_READONLY=false 時）

• create_device、update_device
• assign_ip_to_device、release_ip
• create_subnet、create_rack、create_room、create_building

🔧 技術細節

開發

# 以開發模式運行
npm run dev

# 構建
npm run build

# 運行構建後的版本
npm start

📄 許可證

本項目採用 MIT 許可證。