PanoOn Street View

PanoOn MCP + エージェントスキル

MCP 対応のコーディングエージェントに、PanoOn を通じて Street View データをスキャンしてダウンロードする機能を提供します。mcp/panoon-mcp.mjs は、PanoOn のローカルサービスと分散コントローラーをラップする、依存関係ゼロの MCP stdio サーバーです。

クイックスタート（npm）

npx -y panoon-mcp

npm パッケージ panoon-mcp は panoon-mcp バイナリを公開します。また、https://app.rjfan.org/panoon/mcp/ から panoon-mcp.zip をダウンロードするか、PanoOn 0.2.21 以降に同梱されているもの（<install>\mcp\panoon-mcp.mjs）を使用できます。

前提条件：PanoOn アプリ／サービスが同じマシン上で実行されていること（http://127.0.0.1:8787。デスクトップアプリは 0.2.20 以降、自動的に起動します）。

サーバー

node mcp/panoon-mcp.mjs
# or with the runtime bundled with PanoOn (no Node install required):
"C:\Users\<you>\AppData\Local\PanoOn\panoon-service-runtime.exe" mcp\panoon-mcp.mjs

環境変数：

変数	デフォルト	意味
PANOON_SERVICE_URL	http://127.0.0.1:8787	ローカルサービスのベース URL。

ツール：panoon_status、panoon_area_scan、panoon_area_status、panoon_area_result、panoon_area_cancel、panoon_download、panoon_job_status、panoon_jobs、panoon_workers、panoon_cancel_job。

エージェントごとのインストール

OpenCode（V2）

opencode mcp add panoon --global -- node <repo>\mcp\panoon-mcp.mjs
opencode mcp list

または、~/.config/opencode/opencode.jsonc に手動で設定します。

{
  "mcp": {
    "servers": {
      "panoon": {
        "type": "local",
        "command": ["node", "<repo>/mcp/panoon-mcp.mjs"],
        "environment": { "PANOON_SERVICE_URL": "http://127.0.0.1:8787" }
      }
    }
  }
}

スキル：mcp/skills/panoon/ を OpenCode のスキル用ディレクトリにコピーします（または skills 設定フィールドからフォルダーを参照します）。

Claude Code

claude mcp add --scope user panoon -- node <repo>/mcp/panoon-mcp.mjs

または .mcp.json に設定します。

{ "mcpServers": { "panoon": { "command": "node", "args": ["<repo>/mcp/panoon-mcp.mjs"] } } }

スキル：mcp/skills/panoon/ を ~/.claude/skills/panoon/ にコピーします。

Codex CLI

~/.codex/config.toml に追加します。

[mcp_servers.panoon]
command = "node"
args = ["<repo>/mcp/panoon-mcp.mjs"]
env = { PANOON_SERVICE_URL = "http://127.0.0.1:8787" }

Codex の場合は、mcp/skills/panoon/SKILL.md のワークフローのセクションを AGENTS.md に貼り付けて、エージェントが想定されている手順を把握できるようにします。

その他の MCP クライアント（stdio）

汎用の stdio 契約を使用します。

{
  "command": "node",
  "args": ["<repo>/mcp/panoon-mcp.mjs"],
  "env": { "PANOON_SERVICE_URL": "http://127.0.0.1:8787" }
}

DeepSeek Harness（dsh）

deepseek mcp add panoon --command node --arg <repo>\mcp\panoon-mcp.mjs
deepseek mcp list

これにより ~/.deepseek/mcp.json が書き込まれます（servers.panoon。ツール名はハーネスによって名前空間化されます）。スキルをインストールするには、mcp/skills/panoon/ を ~/.deepseek/skills/panoon/ にコピーします。dsh は Claude Code と同じ SKILL.md 契約を使用します。その後、ハーネスを再起動すると、両方が読み込まれます。

このマシンで動作する例：

deepseek mcp add panoon --command node --arg D:\04_Dev\PanoOn\mcp\panoon-mcp.mjs
copy D:\04_Dev\PanoOn\mcp\skills\panoon %USERPROFILE%\.deepseek\skills\panoon

エージェントの一般的なフロー

1. panoon_status → サービスが正常で、利用可能なストラテジーが表示されます。
2. panoon_area_scan { polygon: [{lat,lng}, ...] } → jobId が返されます。panoon_area_result → PanoID が返されます。
3. 出力ディレクトリをユーザーに確認します。
4. panoon_download { panoids, outputDir } → jobId が返されます。進捗は panoon_job_status で確認します。

安全上の注意：ダウンロードは大容量（画像あたり約 0.5 MB）で、プロキシのクォータを消費します。エージェントはジョブを送信する前に、対象範囲と出力パスを確認してください。スキャンは低コストで、いつでもキャンセルできます。