Soracom MCP Server

🚀 SORACOM MCP サーバー

SORACOM MCP サーバーは、モデルコンテキストプロトコル (MCP) に基づくサーバーで、SORACOM API とのシームレスな統合（一部サポート）を実現します。

🚀 クイックスタート

SORACOM MCP サーバーは、モデルコンテキストプロトコル (MCP) を利用して、SORACOM API との一部統合を可能にするサーバーです。以下の手順でセットアップできます。

📦 インストール

1. Docker イメージの構築

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

2. VSCode の設定

{
  "mcp": {
    "inputs": [
        {
            "type": "promptString",
            "name": "SORACOM_AUTH_KEY",
            "description": "请输入您的 SORACOM 认证密钥。",
            "required": true
        }
    ],
    "outputs": [
        {
            "type": "command",
            "command": "shellCommand",
            "args": [
                "docker run -it --rm -e SORACOM_AUTH_KEY=${input:Soracom Auth Key} soracom-mcp-server:latest"
            ]
        }
    ]
  }
}

📚 ドキュメント

以下は、MCP サーバーがサポートするすべてのツールとその機能の説明です。

課金関連ツール

• getBillingHistory：過去の確定済みの月次課金履歴を取得します。
• getBillingUsage：詳細な課金使用状況を取得します。
• exportBillingInformation：課金情報をエクスポートします。

ログ管理ツール

• .getLogEntries：特定のリソースのログエントリを検索します。
• streamLogs：ログデータをリアルタイムでストリーミングします。
• searchLogEvents：条件に一致するログイベントを検索します。

注文管理ツール

• createOrder：新しい注文を作成します。
• getOrderStatus：注文のステータス情報を取得します。
• cancelOrder：未処理の注文をキャンセルします。

データ同期ツール

• syncData：リソース間のデータを同期します。
• validateDataIntegrity：データの整合性を検証します。
• exportDataSource：データソースの内容をエクスポートします。

デバイス管理ツール

• registerDevice：新しいデバイスを登録します。
• getDeviceStatus：デバイスの稼働状態を取得します。
• updateDeviceSettings：デバイスの設定を更新します。

リソース監視ツール

• monitorResourceUsage：リソースの使用状況を監視します。
• alertThresholdExceeded：閾値を超えた場合に検出して報告します。
• generateReport：リソース使用レポートを生成します。

セキュリティ管理ツール

• createSecurityRule：新しいセキュリティルールを作成します。
• getSecurityPolicy：現在のセキュリティポリシー設定を取得します。
• testSecurityGroup：セキュリティグループのアクセス制御ルールをテストします。

通知サービスツール

• sendNotification：カスタム通知メッセージを送信します。
• subscribeToEvents：特定のイベントの通知を購読します。
• unsubscribeFromUpdates：更新通知の購読を解除します。

データストレージツール

• createDataStore：新しいデータストレージ領域を作成します。
• getDataStoreContents：データストレージ内の内容を検索します。
• deleteOldData：期限切れのデータレコードを削除します。

📚 使用説明

1. ヘルプの取得：詳細な情報については、SORACOM 公式ドキュメント を参照してください。
2. 問題のフィードバック：何か問題が発生した場合は、メールで support@ soracom.io までご連絡ください。