PanoOn Street View

PanoOn MCP + Agent 技能

让任何支持 MCP 的编码 Agent 都能通过 PanoOn 扫描和下载街景数据：mcp/panoon-mcp.mjs 是一个零依赖的 MCP stdio 服务，用于封装 PanoOn 本地服务和分布式控制器。

快速开始（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。

按 Agent 安装

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，以便 Agent 了解预期流程。

其他 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；工具名称会由 Harness 添加命名空间前缀）。将 mcp/skills/panoon/ 复制到 ~/.deepseek/skills/panoon/ 以安装技能——dsh 使用与 Claude Code 相同的 SKILL.md 协议——然后重启 Harness，以加载两者。

在这台机器上，可用的示例如下：

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

典型 Agent 工作流

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），且会消耗代理配额。Agent 应在提交任务前确认范围和输出路径；扫描开销很小，可随时取消。