SORACOM MCP Server

SORACOM MCP Server

SORACOM MCP Server は、SORACOM API（一部）とのシームレスな統合を提供する Model Context Protocol（MCP） サーバーです。

インストール

1. Docker イメージをビルドする

git clone {THIS_REPOSITORY_URL}
cd soracom-mcp-server
docker build -t soracom-mcp-server:latest .

2. VSCode をセットアップする

{
  "mcp": {
    "inputs": [
        {
            "type": "promptString",
            "id": "soracom_auth_key",
            "description": "SORACOM Auth Key",
            "password": true
        },
        {
            "type": "promptString",
            "id": "soracom_auth_key_id",
            "description": "SORACOM Auth Key ID",
            "password": true
         }
    ],
    "servers": {
      "soracom": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SORACOM_AUTH_KEY",
          "-e",
          "SORACOM_AUTH_KEY_ID",
          "soracom-mcp-server:latest"
        ],
        "env": {
          "SORACOM_AUTH_KEY": "${input:soracom_auth_key}",
          "SORACOM_AUTH_KEY_ID": "${input:soracom_auth_key_id}"
        }
      }
    }
  }
}

VS Code で MCP サーバーのツールを使用する方法については、エージェントモードのドキュメントをご覧ください。

ツール

提供されているツールは以下のとおりです。これらのツールは、主に情報の取得を目的として、SORACOM API の一部をサポートしています。 すべての API を呼び出すサービスクラス（2025 年 4 月 15 日時点）は src/generated にあります。追加する場合は、src/handlers/toolsMap ファイルを参照してください。

請求ツール

• getBillingHistory：月ごとの過去の確定済み請求履歴を取得します。
• getBilling：指定した月の確定済み請求を取得します。
• getBillingPerDay：指定した月の日ごとの請求を取得します。
• exportBilling：過去の請求明細 CSV をストレージにエクスポートします。
• getLatestBilling：今月の最新の請求を取得します。
• exportLatestBilling：最新の請求明細 CSV をストレージにエクスポートします。
• getBillingSummaryOfBillItems：過去 4 か月分の請求項目別の請求概要を取得します。
• getBillingSummaryOfSims：過去 4 か月分の SIM 別の請求概要を取得します。

ログツール

• getLogs：対象のログを取得します。

注文ツール

• listOrders：すべての注文を一覧表示します。
• getOrder：注文の詳細を取得します。
• listOrderedSubscribers：指定した注文に含まれるサブスクライバーを一覧表示します。
• listProducts：利用可能な製品の一覧を取得します。
• listAvailableDiscounts：利用可能な長期割引の一覧を取得します。

SIM ツール

• listSims：すべての SIM を一覧表示します。
• getSim：SIM の詳細を取得します。

Soralet ツール

• listSoralets：Soralet の一覧を取得します。
• getSoralet：Soralet の詳細を取得します。
• getSoraletLogs：Soralet のログを取得します。
• testSoralet：引数を指定して Soralet をテストします。
• listSoraletVersions：Soralet バージョンの一覧を取得します。

サブスクライバーツール

• listSubscribers：すべてのサブスクライバーを一覧表示します。
• getSubscriber：サブスクライバーの詳細を取得します。

SoraCam ツール

• listSoraCamDevices: SoraCam デバイスの一覧を取得します。
• getSoraCamDevice: SoraCam デバイスの詳細を取得します。
• getSoraCamDeviceAtomCamSettingsMotion: モーション検知の設定を取得します。
• getSoraCamDeviceAtomCamSettingsMotionSensitivity: モーション検知の感度設定を取得します。
• getSoraCamDeviceAtomCamSettingsNightVision: ナイトビジョンモードの設定を取得します。
• getSoraCamDeviceAtomCamSettingsQuality: 画質設定を取得します。
• getSoraCamDeviceAtomCamSettingsRotation: 画像の回転設定を取得します。
• getSoraCamDeviceAtomCamSettingsSound: 音声検知の設定を取得します。
• getSoraCamDeviceAtomCamSettingsSoundSensitivity: 音声検知の感度設定を取得します。
• getSoraCamDeviceAtomCamSettingsStatusLight: ステータスライトの設定を取得します。
• getSoraCamDeviceAtomCamSettingsTimestamp: タイムスタンプ表示の設定を取得します。
• listSoraCamDeviceEventsForDevice: 特定の SoraCam デバイスのイベント一覧を取得します。
• getSoraCamDeviceExportUsage: SoraCam デバイスのエクスポート使用状況を取得します。
• listSoraCamDeviceImageExportsForDevice: 特定の SoraCam デバイスの画像エクスポート状況一覧を取得します。
• exportSoraCamDeviceRecordedImage: SoraCam デバイスの録画映像から静止画像をエクスポートします。
• getSoraCamDeviceExportedImage: SoraCam デバイスの画像エクスポート状況を取得します。
• getSoraCamDeviceName: SoraCam デバイスの名前を取得します。
• getSoraCamDevicePowerState: SoraCam デバイスの電源状態を取得します。
• listSoraCamDeviceRecordingsAndEvents: SoraCam デバイスの録画期間とイベントの一覧を取得します。
• getSoraCamDeviceStreamingVideo: SoraCam デバイスのストリーミング動画情報を取得します。
• listSoraCamDeviceVideoExportsForDevice: 特定の SoraCam デバイスの動画エクスポート状況一覧を取得します。
• getSoraCamDeviceExportedVideo: SoraCam デバイスの動画エクスポート状況を取得します。
• exportSoraCamDeviceRecordedVideo: SoraCam デバイスの録画動画をエクスポートします。
• listSoraCamDeviceAtomCamFirmwareUpdates: ファームウェアを更新できる SoraCam デバイスの一覧を取得します。
• listSoraCamDeviceEvents: すべての SoraCam デバイスのイベント一覧を取得します。
• listSoraCamDeviceImageExports: すべての SoraCam デバイスの画像エクスポート状況一覧を取得します。
• listSoraCamDeviceVideoExports: すべての SoraCam デバイスの動画エクスポート状況一覧を取得します。
• listSoraCamLicensePacks: SoraCam のライセンスパック一覧を取得します。

DataEntryService ツール

• getDataEntries: 特定のリソースのデータエントリー一覧を取得します。
• getDataEntry: リソース ID とタイムスタンプを指定して、特定のデータエントリーの詳細を取得します。
• listDataSourceResources: オペレーターのすべてのデータソースリソースを一覧表示します。