SORACOM MCP Server

基本能力

产品定位

SORACOM MCP Server 是一个中间件服务，用于通过 MCP 协议与 SORACOM 平台 API 交互，主要提供数据查询和管理功能。

核心功能

1. 账单管理：支持查询历史账单、月度账单、每日账单，并支持导出账单数据。
2. 日志管理：支持获取目标日志。
3. 订单管理：支持查询订单详情、订阅者订单列表、可用产品和折扣信息。
4. SIM卡管理：支持查询 SIM 卡列表和详情。
5. Soralet管理：支持查询 Soralet 列表、详情、日志、测试和版本信息。
6. 订阅者管理：支持查询订阅者列表和详情。
7. SoraCam管理：支持查询摄像头设备列表、详情、设置、事件、导出记录等。

适用场景

1. 财务分析：通过账单工具进行财务数据分析和导出。
2. 设备监控：通过 SoraCam 工具监控摄像头设备状态和事件。
3. 订单管理：通过订单工具管理订阅者和产品订单。
4. 日志分析：通过日志工具分析设备或服务日志。

工具列表

1. Billing Tools：
2. getBillingHistory：获取历史账单。
3. getBilling：获取月度账单。
4. getBillingPerDay：获取每日账单。
5. exportBilling：导出账单数据。
6. getLatestBilling：获取当前月最新账单。
7. exportLatestBilling：导出最新账单数据。
8. getBillingSummaryOfBillItems：获取账单摘要（按账单项）。
9. getBillingSummaryOfSims：获取账单摘要（按 SIM 卡）。
10. Log Tools：
11. getLogs：获取日志。
12. Order Tools：
13. listOrders：列出所有订单。
14. getOrder：获取订单详情。
15. listOrderedSubscribers：列出订单中的订阅者。
16. listProducts：列出可用产品。
17. listAvailableDiscounts：列出可用折扣。
18. SIM Tools：
19. listSims：列出所有 SIM 卡。
20. getSim：获取 SIM 卡详情。
21. Soralet Tools：
22. listSoralets：列出 Soralet。
23. getSoralet：获取 Soralet 详情。
24. getSoraletLogs：获取 Soralet 日志。
25. testSoralet：测试 Soralet。
26. listSoraletVersions：列出 Soralet 版本。
27. Subscriber Tools：
28. listSubscribers：列出所有订阅者。
29. getSubscriber：获取订阅者详情。
30. SoraCam Tools：
31. listSoraCamDevices：列出 SoraCam 设备。
32. getSoraCamDevice：获取 SoraCam 设备详情。
33. 其他工具用于管理摄像头设置、事件、导出记录等。

使用教程

使用依赖

1. 安装 Docker。
2. 安装 Git。

安装教程

1. 克隆仓库并构建 Docker 镜像： bash git clone {THIS_REPOSITORY_URL} cd soracom-mcp-server docker build -t soracom-mcp-server:latest .
2. 配置 VSCode：
3. 在 VSCode 中配置 mcp 输入参数（如 SORACOM 认证密钥）。
4. 参考 agent mode documentation 完成配置。

调试方式

1. 运行 Docker 容器： bash docker run -i --rm -e SORACOM_AUTH_KEY -e SORACOM_AUTH_KEY_ID soracom-mcp-server:latest
2. 检查日志和输出是否符合预期。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。