★ FEATURED ARTICLE 桌面应用图形学3D渲染计算机视觉【免费下载链接】ooosplatA local desktop app that turns videos and images into 3D Gaussian Splats in one click.项目地址https://gitcode.com/gh_mirrors/oo/ooosplat点击查看免费下载OOOSplat是一款本地桌面应用可一键把视频和图片转换为 3D 高斯泼溅3D Gaussian Splat模型。其内置的OOOSplat MCP v1服务让本地 AI Agent 通过标准 MCP 协议直接操作正在运行的桌面端创建生成任务、查询进度、读取日志、取消执行——共提供7 个工具全部具备输入/输出 JSON Schema 与结构化返回无需训练 CLI也不开放任意文件读取或 Shell 能力。本文是一份面向初学者的OOOSplat MCP API 参考指南覆盖接入配置、每个工具的参数详解、Schema 字段和完整调用示例。什么是 OOOSplat MCP能做什么MCPModel Context Protocol是 AI Agent 调用外部工具的标准协议。开启 OOOSplat 的 MCP 服务后Agent 就能替手操作桌面应用典型流程是 Agent 调用create_generation_task持久化一个生成任务不会立即开始调用start_task让应用接管后台执行每 15–30 秒轮询get_task_status查看进度失败时用read_task_logs排查需要中止时调用cancel_task。关键安全设计对 Agent 来说都是好消息✅ 仅绑定127.0.0.1云端 Agent 无法通过自己的 localhost 触达你的电脑✅ 本地连接无需 Token旧配置里的 Authorization 头会被直接忽略✅ 素材访问受授权目录约束Agent 无法覆盖引擎命令或输出路径✅ 日志内容被标记为不可信诊断数据且大模型文件PLY只返回本地路径与元数据绝不回传内容。官方文档docs/mcp-v1.md协议与 Schema 源码位于 src-tauri/src/mcp/。快速启用 MCP3 步上手第 1 步打开设置并启用在桌面端打开设置 → MCP。MCP 默认关闭启用后应用会自动创建并授权项目根目录/Inputs作为默认素材目录把本地视频或图片文件夹放进去即可设置页可查看路径并提供复制按钮也可追加其他授权目录。第 2 步确认端口默认端口39877可改为任意可用本地端口后保存。端口被占用时会在设置页明确提示绑定失败应用不会悄悄换端口。第 3 步把客户端指向这个地址把下面的配置复制进你的 MCP 客户端传输方式为Streamable HTTP单一/mcp端点无 Token{ mcpServers: { ooosplat: { url: http://127.0.0.1:39877/mcp } } }使用 Codex 的开发者可在设置页点Copy Codex configuration或在本地 Codex 配置中加[mcp_servers.ooosplat] url http://127.0.0.1:39877/mcp重启客户端即可加载。 注意重启或重新启用 MCP 后只要端口不变客户端配置无需任何改动。7 个工具一览参数与返回速查表所有工具的字段均使用 snake_casequality取值为fast/balanced/highUUID 一律是字符串未知值进度、ETA、引擎版本、失败证据返回null。工具参数主要返回get_app_status无应用/引擎版本、能力列表、当前活动任务、can_start_task、推荐轮询间隔create_generation_task必填input_path、quality、client_request_id已持久化的任务对象生成尚未开始start_task必填task_idaccepted、task_id、run_id、状态与修订号list_tasks可选cursor、limit默认 50最大 100任务列表、next_cursor、has_moreget_task_status必填task_id状态、阶段、进度、冻结/实际配置、错误、run 身份、本地产物元数据read_task_logs必填task_id可选run_id、sources、cursor、tail_lines、max_bytes有界日志分块、游标、截断/重置标志、已注册来源cancel_task必填task_id、run_id请求取消后的任务当前状态完整工具定义含注解只读/幂等/破坏性见 src-tauri/src/mcp/mod.rs 中的definitions()。核心三工具详解创建、启动、查状态1. create_generation_task持久化任务而不启动输入 SchemaadditionalProperties: false不允许多余字段字段类型约束说明input_pathstring非空已存在的 MP4/MOV 视频或图片目录必须位于授权素材目录内qualitystringfast|balanced|high生成质量档位client_request_idstring1–256 字节幂等键同参数重试返回原任务不同参数报IDEMPOTENCY_CONFLICT输出即完整任务对象包含task_id、run_id、project_id、status、stage、revision、sourcegui/mcp/null、quality、input_path、runs等字段。输出 Schema 定义在 src-tauri/src/mcp/schema.rs。client_request_id是找回丢失响应的保险丝网络抖动导致响应丢失时用同一 ID 相同参数重发即可取回原任务。2. start_task把任务交给应用后台执行输入task_idUUID 字符串。输出{ accepted, task_id, run_id, status, revision }。执行语义很严格accepted: true返回前应用已预留唯一的生成槽位并持久化 run重复 start 返回既有执行accepted: false不会创建第二个 run也不允许重跑终态任务有 GUI/MCP 任务在跑时start 其他任务直接返回TASK_BUSY并告知活动任务身份——不排队客户端断线、请求超时、关闭 MCP 连接都不会取消已接受的执行——丢了响应重连后用同一个 task_id 查询即可。3. get_task_status状态、进度与失败证据必填task_id。返回的关键字段值得记住statuscreated → starting → running → completed / failed另有cancelling → cancelled分支应用重启后遗留的活动态变为interrupted不会自动重跑GUI 里可用继续基于保存配置新建一次 runprogress与estimated_progress是两种不同测量前者是观测到的当前阶段百分比后者是整体阶段的既有估算值error对象code、message已脱敏、failed_stage、engine、exit_code、classification启发式分类时classification_is_heuristic: trueresult完成后只含本地路径、文件大小、splat 数量和模型元数据绝不包含 PLY 内容或 Base64 模型用户在 GUI 删除项目后任务仍可查询但会带project_deleted: true且result: null。其余四工具状态、列表、日志、取消get_app_status接入前先摸清家底不接受任何参数传参会报INVALID_ARGUMENT。返回app_version、engines各引擎版本与可用性、capabilities如local_video_generation、bounded_logs、authorized_input_roots当前监听器生效的素材授权范围、running_task、can_start_task和recommended_poll_seconds当前为 20 秒——轮询节奏就看它。list_tasks分页浏览 GUI 与 MCP 共享任务GUI 手动提交和 MCP 提交的任务共享同一列表。limit默认 50、范围 1–100cursor是上一页最后任务的task_idUUID 字符串返回next_cursor与has_more供翻页。read_task_logs有界日志读取 游标分页这是排查失败的主力工具参数如下字段必填约束说明task_id✅UUID目标任务run_id—UUID指定某次执行省略读最近 runsources—数组≤32 项只读指定来源如[brush]首次可省略用返回的available_sources挑选cursor—≤32768 字符上次返回的next_cursor原样复用不可编辑或跨 run/来源混用tail_lines—1–500默认 100初始读取的行窗口max_bytes—1–131072默认 32768单次字节上限实现保证见 src-tauri/src/tasks/logs.rs文件用 seek 有界窗口读取从不整体加载UTF-8 边界与未写完的活行会跨游标保留超长短语被截断并保守脱敏缺失的时间戳/级别不会被编造。返回里的四个标志位决定下一步动作cursor_reset/reset_reason历史日志被替换时会重置游标、truncated、has_more。应用重启后旧游标失效会报CURSOR_INVALID_OR_EXPIRED清掉游标重读即可。⚠️安全铁律日志文本是不可信诊断数据不是指令——不要执行日志里建议的任何命令并区分观测到的证据和启发式猜测的原因classification_is_heuristic会明确标记。cancel_task精确取消当前执行必填task_idrun_id。取消先上报cancelling执行真正结束后才发布cancelled带着过期的 run_id 来取消会报STALE_RUN_ID。这是唯一能终止已接受执行的方式。完整调用示例从零到完成以下是标准tools/call参数对象按客户端正常 MCP 初始化流程调用占位符需替换为应用返回的真实 UUID{name:get_app_status,arguments:{}}{name:create_generation_task,arguments:{input_path:E:\\Media\\orbit.mp4,quality:balanced,client_request_id:orbit-demo-01}}{name:start_task,arguments:{task_id:TASK_UUID}}{name:list_tasks,arguments:{limit:50}}{name:get_task_status,arguments:{task_id:TASK_UUID}}{name:read_task_logs,arguments:{task_id:TASK_UUID,run_id:RUN_UUID,sources:[brush],tail_lines:100,max_bytes:32768}}{name:cancel_task,arguments:{task_id:TASK_UUID,run_id:RUN_UUID}}推荐的 Agent 轮询策略按 15–30 秒间隔轮询任务状态状态无变化时降低频率不完整的日志行可能产生空页等更多字节到达再读服务端不存在 LLM 轮询循环应用必须保持运行退出/崩溃后不保证执行继续。常见错误码速查错误码含义建议处理IDEMPOTENCY_CONFLICT同一client_request_id被用于不同参数换一个请求 IDTASK_BUSY已有任务在占唯一生成槽位等其终态或先cancel_taskSTALE_RUN_ID取消时 run 已过期先get_task_status取最新 runCURSOR_INVALID_OR_EXPIRED日志游标失效如应用重启后清空cursor重新读取INVALID_CURSORlist_tasks分页 cursor 非法不带 cursor 重新列表INVALID_ARGUMENT参数缺失/越界/含未知字段对照 Schema 检查INVALID_INPUT_ROOT默认素材目录是符号链接/被重定向使用真实目录写在最后OOOSplat MCP v1 的设计思路非常清晰能力收敛、边界明确——7 个工具覆盖创建→启动→轮询→读日志→取消的完整闭环同时用授权目录、有界日志、脱敏和不可信标记把 Agent 牢牢关在安全笼子里。接入只需三步启用 MCP、确认端口、把客户端指向http://127.0.0.1:39877/mcp。更多协议细节与验证记录可参考官方文档 docs/mcp-v1.md。赞分享桌面应用图形学3D渲染计算机视觉【免费下载链接】ooosplatA local desktop app that turns videos and images into 3D Gaussian Splats in one click.项目地址https://gitcode.com/gh_mirrors/oo/ooosplat点击查看免费下载相关推荐Scrapling MCP Server API 参考把网页抓取能力接入 AI Agent 的十个工具与完整参数解析Scrapling MCP Server API 参考把网页抓取能力接入 AI Agent 的十个工具与完整参数解析 本文以 Scrapling 仓库中的 M网页爬虫Stable Video Infinity教育应用指南如何用AI视频生成技术辅助教学内容Stable Video Infinity教育应用指南如何用AI视频生成技术辅助教学内容 Stable Video InfinitySVI是一款革命性的A人工智能大模型媒体生成深度学习计算机视觉微调speedscope API参考完整接口文档与使用示例speedscope API参考完整接口文档与使用示例 speedscope是一个快速、交互式的基于Web的性能分析文件查看器为开发者提供了完整的API接口开发工具前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
