Device42 MCP

🚀 Device42 MCP Server

Device42のIT資産管理用のMCPサーバー - Node.js/TypeScriptによる実装です。

✨ 主な機能

• ゼロインストール：npx device42-mcp で直接実行できます。
• 高速：ネイティブの fetch（Node 18+）を使用しているため、重いHTTPライブラリは必要ありません。
• 型安全：完全なTypeScriptで記述されています。
• 最小限の依存関係：@modelcontextprotocol/sdk と zod のみです。
• 読み取り/書き込みモード：D42_READONLY=false を設定すると、書き込み操作を有効にできます。
• DOQLサポート：Device42の強力なクエリ言語を使用して複雑なクエリを実行できます。

💻 使用例

質問の例

設定が完了すると、AIアシスタントに以下のような質問をすることができます。

基本的なクエリ

• "NYCデータセンター内のすべてのデバイスをリストアップして"
• "サーバーweb - prod - 01のIPアドレスは何ですか？"
• "Ubuntuを実行しているすべてのデバイスを表示して"
• "ラックA - 15にあるデバイスはどれですか？"
• "「production」とタグ付けされたすべてのデバイスを見つけて"

ネットワークとIP管理

• "10.0.1.0/24サブネットで利用可能なIPアドレスはどれですか？"
• "データベースサーバーに割り当てられたすべてのIPアドレスを表示して"
• "本社ビル内のすべてのVLANをリストアップして"
• "192.168.1.50はどのサブネットに属していますか？"

インフラストラクチャの概要

• "ロンドンデータセンター内のすべてのラックの概要を教えて"
• "オペレーティングシステムごとにデバイスはいくつありますか？"
• "すべてのビルとその部屋数をリストアップして"
• "現在使用しているハードウェアモデルは何ですか？"

DOQLクエリ（高度な使用法）

サーバーはDOQL（Device42 Object Query Language）をサポートしており、複雑なクロステーブルクエリが可能です。

• "過去30日以内に追加された、RAMが64GBを超えるすべてのデバイスを見つけるDOQLクエリを実行して"
• "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)

macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsの場合は %APPDATA%\Claude\claude_desktop_config.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"
      }
    }
  }
}

Claude Desktop (Docker)

macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsの場合は %APPDATA%\Claude\claude_desktop_config.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"
      ]
    }
  }
}

📦 インストール

グローバルインストール

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