Soracom MCP Server

🚀 SORACOM MCP 服務器

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：刪除過期的數據記錄。

📚 詳細文檔

使用說明

• 獲取幫助：如需更多信息，請訪問 SORACOM 官方文檔。
• 反饋問題：遇到任何問題，可通過郵件聯繫 support@ soracom.io。