Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SORACOM Data Reader MCP show me the latest sensor data for SIM 440101234567890"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SORACOM APIを活用したデータ分析向けMCP（Model Context Protocol）サーバーです。
SORACOM Harvest Data、Harvest Files、ソラカメのデータを取得・分析するためのツールを提供します。 認証にはSAMユーザーの認証キーを使用します。
Related MCP server: CMP MCP Server
API | 説明 | モード |
| 特定SIMのHarvest Dataを取得 |
|
| リソース単位でデータ取得 |
|
API | 説明 | モード |
| ファイル・ディレクトリ一覧取得 |
|
| ファイルダウンロード（ |
|
| ストレージ使用状況 |
|
API | 説明 | モード |
| カメラ一覧取得 |
|
| カメラ詳細情報取得 |
|
API | 説明 | モード |
| 録画一覧取得 |
|
| 録画エクスポート開始 |
|
| エクスポート状況確認 |
|
| 静止画取得 |
|
| ストリーミングURL取得 |
|
API | 説明 | モード |
| イベント一覧取得 |
|
| イベント詳細取得 |
|
API | 説明 | モード |
| SIM一覧取得 |
|
| 特定SIM情報取得 |
|
| グループ一覧取得 |
|
| SIM通信統計（データ使用量） |
|
| Harvest利用統計 |
|
このMCPを使用するには、SORACOM SAMユーザーの認証キーを取得する必要があります。
SORACOMユーザーコンソール にログイン
右上のアカウントメニュー → 「セキュリティ」を選択
「SAMユーザー」タブを選択
SAMユーザーを作成（または既存のユーザーを選択）
「認証キー」を生成
authKeyId と authKey をメモ
SAMユーザーには以下の権限が必要です：
harvest:getDataEntry - Harvest Data読み取り
files:getObject - Harvest Files読み取り
files:listObjects - Harvest Files一覧取得
SoraCam:* - ソラカメ操作（必要に応じて絞り込み可）
subscriber:getSubscriber - SIM情報読み取り
stats:getAirStats - 通信統計読み取り
# GitHubから直接インストール
uv tool install git+https://github.com/leaveanest/alt-soracom-data-reader-mcp.git
# 実行
soracom-data-mcp --mode harvest# または、uvxで一時的に実行（インストール不要）
uvx --from git+https://github.com/leaveanest/alt-soracom-data-reader-mcp.git soracom-data-mcp --mode harvestモード | 説明 |
| Harvest Data/Files取得 |
| ソラカメ映像・イベント取得 |
| SIM情報・通信統計取得 |
| 全ツール（開発用） |
export SORACOM_AUTH_KEY_ID="keyId-xxx" # 必須
export SORACOM_AUTH_KEY="secret-xxx" # 必須
export SORACOM_COVERAGE="jp" # オプション（デフォルト: jp）{
"mcpServers": {
"soracom-harvest": {
"command": "soracom-data-mcp",
"args": ["--mode", "harvest"],
"env": {
"SORACOM_AUTH_KEY_ID": "keyId-xxx",
"SORACOM_AUTH_KEY": "secret-xxx"
}
}
}
}{
"mcpServers": {
"soracom-harvest": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/leaveanest/alt-soracom-data-reader-mcp.git",
"soracom-data-mcp", "--mode", "harvest"
],
"env": {
"SORACOM_AUTH_KEY_ID": "keyId-xxx",
"SORACOM_AUTH_KEY": "secret-xxx"
}
}
}
}{
"mcpServers": {
"soracom-harvest": {
"command": "uv",
"args": ["run", "soracom-data-mcp", "--mode", "harvest"],
"env": {
"SORACOM_AUTH_KEY_ID": "keyId-xxx",
"SORACOM_AUTH_KEY": "secret-xxx"
}
}
}
}APIにはレート制限があります
ソラカメAPIはソラカメ契約が必要です
Harvest Data/FilesはHarvest契約が必要です
特定SIMのHarvest Dataを取得します
Args: imsi: SIMのIMSI from_time: 取得開始時刻（UNIXタイムスタンプ・ミリ秒） to_time: 取得終了時刻（UNIXタイムスタンプ・ミリ秒） sort: ソート順（asc: 古い順, desc: 新しい順） limit: 取得件数（最大1000） last_evaluated_key: ページング用キー
Returns: Harvest Dataのリストと次ページのキー
Inputs: imsi (required), from_time, to_time, sort, +2 more. Returns: object
リソースタイプとIDでHarvest Dataを取得します
Args: resource_type: リソースタイプ（subscriber, device など） resource_id: リソースID from_time: 取得開始時刻（UNIXタイムスタンプ・ミリ秒） to_time: 取得終了時刻（UNIXタイムスタンプ・ミリ秒） sort: ソート順（asc: 古い順, desc: 新しい順） limit: 取得件数（最大1000） last_evaluated_key: ページング用キー
Returns: Harvest Dataのリストと次ページのキー
Inputs: resource_type (required), resource_id (required), from_time, to_time, +3 more. Returns: object
Harvest Filesのファイルダウンロード用URLを取得します
Args: scope: スコープ（private または operators/{operator_id}） path: ファイルパス
Returns: ダウンロード用URL（リダイレクトURL）
Inputs: scope (required), path (required). Returns: object
Harvest Filesのストレージ使用状況を取得します
Args: scope: スコープ（private または operators/{operator_id}）
Returns: ストレージ使用状況（使用量、ファイル数など）
Inputs: scope. Returns: object
Harvest Filesのファイル・ディレクトリ一覧を取得します
Args: scope: スコープ（private または operators/{operator_id}） path: パス（デフォルト: /） limit: 取得件数 last_evaluated_key: ページング用キー
Returns: ファイル・ディレクトリ一覧
Inputs: scope, path, limit, last_evaluated_key. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap. get_harvest_data retrieves data by SIM IMSI, get_harvest_data_by_resource retrieves data by resource type/ID, get_harvest_file_download_url gets download URLs, get_harvest_file_info gets storage usage, and list_harvest_files lists files/directories. The descriptions make it easy to differentiate between data retrieval methods and file management operations.
All tools follow a consistent verb_noun pattern with 'get_' or 'list_' prefixes followed by descriptive nouns. The naming is perfectly uniform across all five tools, making them predictable and easy to understand at a glance.
Five tools is an ideal number for this server's purpose of reading SORACOM Harvest data and files. Each tool serves a specific, necessary function without redundancy, covering both data retrieval (by SIM and resource) and file management operations in a well-scoped manner.
The toolset provides comprehensive read-only coverage for Harvest data and files, including multiple query methods, file listing, download URLs, and storage info. The only minor gap is the lack of write/update operations, but as a 'Data Reader' server, this aligns with its stated purpose, and agents can work effectively within this read-only scope.
DePIN supply telemetry and network data with source, as_of, and verification links. Discover datasets, inspect provenance, and retrieve data through Streamable HTTP. Data access requires an API key.
Authenticated public evidence search, verification, research jobs, exports, and webhooks.
Read-only access to authorized SolarSENS solar plants, performance, devices, and alarms.
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.
