桌面应用视频网络MCP 服务【免费下载链接】wx_channels_download微信视频号下载器项目地址https://gitcode.com/gh_mirrors/wx/wx_channels_download点击查看免费下载导读微信视频号下载器wx_channels_download将 MCPModel Context Protocol服务封装为一组可通过 AI 客户端对话直接调用的「命令」——每个命令本质是一个工具tool由 AI 客户端以 JSON 参数形式发起调用。本文基于 docs/feature/mcp/commands.md系统梳理这些命令的用途、参数约束、返回语义与源码级实现细节覆盖应用配置管理、Worker 部署、内容解析下载、微信视频号专项操作和本地数据查询五大类工具帮助你精准掌握每个命令的调用前提、边界条件与安全注意事项。前置先启用 MCP 服务所有命令都通过 MCP 服务暴露。按 启用 MCP 指南正常启动下载器后 MCP 默认关闭需打开http://127.0.0.1:2022/点击「设置 → MCP」启用开关仅当前进程生效不写入配置文件。默认地址为http://127.0.0.1:2022/mcp在 AI 客户端中新增Streamable HTTP类型的 MCP Server 并填入该地址即可。命令调用由 AI 客户端负责发起例如对 codex 说使用 dm MCP 服务 查找昵称为 我不叫龙虾 的视频号账号获取最新的10条视频从源码结构看MCP 服务通过 Streamable HTTP 传输暴露见 internal/mcpserver/http.go工具调用在 POST 请求的响应中直接返回 JSON-RPC 结果并校验 Content-Type 为application/json、Origin 与请求 Host 一致。全部工具定义集中在 internal/mcpserver/tools.go 的tool_definitions()中按应用配置、抓取任务、视频号、下载、SPH Worker、知乎、本地数据等模块聚合注册实际可用的工具子集由supports_tool()按服务端能力动态过滤。应用配置get_config / update_config / get_restart_status这是管理下载器配置的「读-改-验」三件套核心原则是改配置不直接改文件而是保存后自动重启重启结果必须显式确认。工具主要参数用途get_config无获取可配置字段的 schema、当前值和解析后的生效值密码、Cookie、Token 等敏感字段不返回明文。update_configvalues批量校验并保存非只读配置实际值发生变化后自动安排应用优雅重启。get_restart_statusrestart_token在连接恢复后确认是否已切换到新进程以及新进程加载的配置是否与保存结果一致。get_config字段结构get_config将 internal/config/config.go 注册的应用配置放在application_fields将 adapter 提供的配置放在plugin_fields并在兼容字段fields中返回两者合集。每个字段还带有source插件字段额外带有namespace。敏感字段只返回「是否已配置」的布尔状态如configured不返回明文从设计上避免凭证经 MCP 通道外泄。update_config保存与重启的边界update_config的键必须来自get_config值必须符合字段类型和options枚举约束。配置写入采用原子替换方式。关键语义如下成功响应中的restart_scheduled: true只表示重启已经安排不能据此宣称重启完成调用方必须保存返回的restart_token在连接恢复后调用get_restart_status提交的值与当前值完全相同时不会写盘或重启。get_restart_status四种状态判定只有响应同时满足status: completed、restart_completed: true和config_applied: true才能确认新进程已经运行且保存后的配置已经加载。其余状态语义状态含义与处理pending仍是旧进程需要在连接恢复后继续重试failed重启请求失败config_mismatch进程已更换但配置摘要不一致配置未按保存结果加载重启期间 HTTP、WebSocket 和 MCP 连接可能短暂断开客户端应重新连接。若修改了api.hostname或api.port应改用新地址连接stdio 客户端也需要更新 API 地址或重新启动。实战场景修改下载目录先调用get_config确认download.dir的类型和当前值再调用{ name: update_config, arguments: { values: { download.dir: /data/downloads } } }工具返回成功后只代表重启已安排。连接恢复后将返回的restart_token传给get_restart_status确认其返回completed且config_applied: true后才能告知用户下载器已重启、新目录已经生效。新建下载任务将使用新的默认目录。该流程的完整描述见 修改下载目录场景。从源码看internal/mcpserver/tools.goupdate_config要求values至少包含一个配置项get_restart_status要求restart_token非空去除首尾空白后校验参数结构体通过DisallowUnknownFields()严格反序列化任何未知字段都会直接报「工具参数无效」杜绝 AI 客户端传错键名。Worker 部署deploy_sph_worker工具主要参数用途deploy_sph_worker无从应用配置读取 Cloudflare 凭证部署或覆盖视频号查询 Worker并返回 workers.dev 地址。该工具是少数无参数却具有破坏性的命令它读取cloudflare.accountId、cloudflare.apiToken、cloudflare.sphWorkerName、cloudflare.sphCookie和cloudflare.sphCredential不会通过 MCP 参数传输这些敏感值——敏感部署配置刻意不作为工具参数暴露见 internal/mcpserver/sph_tools.go 中SphDeployer接口的注释。调用会覆盖同名远端 Worker因此必须先获得用户确认。get_config可用时可先检查这些字段的configured状态避免部署到一半才发现凭证缺失。成功返回的SphDeployResult包含worker_id、worker_name、worker_url、worker_url_warning和script_bytes等字段。内容解析与下载工具主要参数用途get_platform_status无获取支持的平台及其当前可用状态。fetch_contenturl可选force_refresh、timeout_seconds解析内容链接返回规范化内容、下载预览和可复用的job_id。download_contentjob_id、兼容参数fetch_id或url三选一创建并启动下载任务支持目录、文件名、视频规格、重复任务策略和等待完成等参数。decrypt_wxchannels_videofile_path、key原地解密由第三方下载器保存的视频号视频。::: danger 写文件操作download_content会写入下载目录调用前应先确认下载目标和覆盖策略。existing_action: overwrite会覆盖已有任务及文件。decrypt_wxchannels_video会原地覆盖指定文件只能在fetch_content返回requires_decryption: true时使用。 :::fetch_content解析链接与下载预览fetch_content必填url必须是有效的 http/https 链接可选参数force_refresh默认false忽略抓取缓存重新获取timeout_seconds默认300取值范围1到3600源码中timeout_duration()兜底与上限校验见 internal/mcpserver/tools.go。返回内容包含规范化内容、账号信息、内容详情、缓存条目和下载预览以及可复用的job_id。源码层面fetch_content会创建抓取任务create_scraper_job并轮询等待其完成wait_scraper_job任务状态包括completed、failed、interrupted轮询超时会主动中断任务并返回结构化错误。微信视频号结果的特殊字段当平台为wxchannels时fetch_content_output()会额外把下载信息规范化为download_resources数组见 internal/mcpserver/tools.go每一项包含resource原始资源信息endpoints可用的下载端点列表download_url优先选取Enabled ! 0且非空的端点地址decode_key从资源extra.decode_key提取的解密密钥字符串形式requires_decryption当decode_key非空时为true。download_content创建并启动下载任务download_content的定位参数为job_id、fetch_idjob_id的旧名称仅兼容已有调用已标记 deprecated与url三选一其余参数参数默认值/约束说明download_dir空下载目录留空使用应用配置filename空可选自定义文件名force_refreshfalse直接传url时忽略抓取缓存existing_actionerror枚举error/skip/overwrite/duplicateoverwrite会覆盖已有任务及文件video_variant_key空可选的视频规格variant_keyvideo_variant_spec空可选的视频规格名称同时兼容适配器的spec配置wait_for_completionfalse是否等待实际下载结束后再返回timeout_seconds300解析链接及可选等待下载完成的最长秒数范围1到86400源码校验internal/mcpserver/tools.gojob_id与fetch_id不能指向不同任务existing_action会映射为下载配置中的overwrite/duplicate布尔标记任务创建后默认auto_start: true立即启动返回created、started、skipped、task、ids、source含job_id、platform、url等字段若命中已有任务且策略为skip则返回skipped: true与existing_task设置wait_for_completion时轮询任务状态5为完成6/7为失败/取消。decrypt_wxchannels_video解密第三方下载的视频当fetch_content返回的download_resources中某项requires_decryption: true时可使用该工具对已下载文件原地解密file_path必须是运行下载器服务的同一台机器上的绝对路径源码用filepath.IsAbs校验key原样传入该资源项中的字符串形式decode_key使用字符串传递以避免大整数精度丢失源码用ParseUint解析为 64 位十进制数且要求非零。典型流程见 使用第三方下载器保存视频号视频将download_url交给 aria2、curl 等第三方下载器下载完成后仅当requires_decryption为true时调用decrypt_wxchannels_video。直接下载链接的完整对话示例见 下载视频。微信视频号专项工具这些工具通过已打开的微信视频号页面访问微信接口。先调用get_wxchannels_status确认返回的available为true即已有视频号页面通过 WebSocket 连接到下载器再使用其余工具。工具主要参数用途get_wxchannels_status无检查视频号页面是否已连接。search_wxchannels_accountskeyword可选next_marker搜索视频号账号。get_wxchannels_account_videosusername可选next_marker获取账号发布的视频列表。get_wxchannels_live_replaysusername可选next_marker获取账号的直播回放。get_wxchannels_interacted_videos可选flag、next_marker获取当前用户赞过或收藏的视频flag默认值为7。get_wxchannels_followed_accounts可选next_marker获取当前用户关注的视频号账号。get_wxchannels_play_history可选next_marker获取当前用户最近的视频号播放记录。get_wxchannels_video_profileurl或oidnid或eid获取单个视频详情。get_wxchannels_video_commentsoidnid或oidcomment_id可选next_marker获取一级评论或指定根评论的回复。get_wxchannels_video_share_urloid获取视频的 H5 分享链接。分页游标语义列表工具会保留微信接口的分页字段。继续翻页时将上一页data.lastBuffer原样传给next_marker只有账号搜索使用data.lastBuff注意拼写差异。游标不需要解码或修改直接透传即可见 internal/mcpserver/wxchannels_tools.go 中各工具的参数 schema 描述。各工具参数细节get_wxchannels_video_profile三种定位方式互斥——传url、传oidnid、或只传eid加密的视频对象 ID不可混用源码validate_wxchannels_video_selector类似逻辑。get_wxchannels_video_commentsoid必填查询一级评论时传nid查询某条根评论的回复时传comment_id二选一。get_wxchannels_interacted_videosflag是视频号页面使用的tabFlag默认7须为正整数。get_wxchannels_account_videos / get_wxchannels_live_replaysusername必填可使用搜索结果中的username缺少finder后缀时会自动补齐。所有视频号工具都通过call_wxchannels_api转发到下载器本地接口如/api/channels/contact/search、/api/channels/feed/profile等响应中errCode非零时返回结构化错误附带原始响应内容便于排查。快速下载命令补充除通用下载流程外命令集还包含两个「一条命令直达下载」的快捷工具见 internal/mcpserver/wxchannels_download_tools.godownload_wxchannels_video最快方式是只传视频号分享链接url已有列表结果时也可传oidnid或只传eid无需先调用get_wxchannels_video_profile、fetch_content或download_content。download_wxchannels_live按精确昵称或finder结尾的username自动定位当前直播并直接创建下载任务只需传account不要先获取流地址也不要把直播 FLV 地址传给download_content。两个工具均支持download_dir、filename、existing_action默认error避免重复下载参数标注为破坏性操作destructiveHint: true调用前需用户明确确认。本地只读数据工具本地数据工具均为只读并支持用筛选参数减少返回量。运行模式下存在双后端Streamable HTTP 直接使用当前进程中的数据库与运行时服务data_reader接口stdio 则通过下载器 API 查询相同数据api_client。所有工具定义集中在 internal/mcpserver/data_tools.go。工具主要参数用途get_download_taskspage、page_size、statuses、parent_task_id、root_task_id分页获取下载任务和状态统计。状态0至7分别表示等待、准备、下载中、暂停、合并、完成、失败、取消。get_download_task_detailid获取任务、文件、进度、关联内容和账号详情。get_accountspage、page_size、keyword、account_id分页查询数据库中的平台账号。get_browse_historypage、page_size、keyword、username、platform_ids分页查询浏览记录username是数据库账号 ID例如wxchannels:xxx。get_logspage、page_size、max_bytes、keyword、source、levels、format_json分页读取并筛选应用日志。get_certificate_status无获取代理根证书的来源、安装、信任状态和风险提示。get_download_tasks任务状态机任务状态数值含义源码 schema 中 0–7状态值含义0等待1准备2下载中3暂停4合并5完成6失败7取消statuses数组每个元素必须在 0 到 7 之间page从 1 开始默认 1page_size默认 20、上限 100parent_task_id只返回指定父任务的直接子任务root_task_id只返回属于指定根任务的任务。当查询服务可用时走进程内data_reader否则降级为调用下载器 HTTP API。get_accounts 与 get_browse_historyget_accounts的keyword可按账号 ID、平台外部 ID、别名和昵称模糊搜索account_id可精确筛选数据库账号 IDpage_size默认 24、上限 200。get_browse_history的keyword匹配标题、内容 ID、链接或关联账号username传数据库账号 ID如wxchannels:xxxplatform_ids留空时查询常用平台。get_logs 与 get_certificate_statusget_logs默认从每个日志文件末尾读取最大 2 MBmax_bytes范围 64 KB 到 10 MBpage_size默认 300、上限 2000支持keyword不区分大小写、source日志来源/文件/组件和levels如debug、info、warn、error过滤。get_certificate_status返回代理根证书的来源、安装和信任状态、证书详情及风险提示用于排查代理与 HTTPS 问题。实战场景排查下载失败先用get_download_tasks筛选失败任务再读取任务详情和相关日志{ name: get_download_tasks, arguments: { statuses: [6], page: 1, page_size: 20 } }取得任务 ID 后调用get_download_task_detail再根据错误文本调用get_logs通过keyword、source或levels: [error]缩小范围。遇到代理或 HTTPS 问题时可追加调用get_certificate_status检查根证书安装和信任状态。完整流程见 排查下载失败。调用安全与最佳实践小结综合 docs/feature/mcp/commands.md 与源码实现使用这套 MCP 命令时应遵循以下实践配置修改三步走get_config确认字段 →update_config提交并保存restart_token→ 连接恢复后get_restart_status确认completedrestart_completed: trueconfig_applied: true三条件齐备才可宣告成功pending需重试failed视为失败config_mismatch需检查配置摘要写操作先确认download_content、download_wxchannels_video、download_wxchannels_live、deploy_sph_worker、decrypt_wxchannels_video均标记为破坏性操作调用前需用户明确确认existing_action: overwrite会覆盖已有任务与文件敏感信息不外传配置中的密码、Cookie、Token 不返回明文Cloudflare 凭证不通过 MCP 参数传输仅从应用配置读取微信视频号工具依赖已打开的视频号页面连接使用前务必检查get_wxchannels_status返回available: true分页游标透传列表工具翻页时把上一页data.lastBuffer原样传入next_marker账号搜索例外使用data.lastBuff不要解码或修改。掌握以上工具清单与调用约束后即可让 AI 客户端安全、高效地驱动下载器完成配置调整、视频号检索、内容下载与本地数据查询等完整工作流。赞分享桌面应用视频网络MCP 服务【免费下载链接】wx_channels_download微信视频号下载器项目地址https://gitcode.com/gh_mirrors/wx/wx_channels_download点击查看免费下载相关推荐微信视频号下载器 MCP 实战查询账号内容与浏览记录的完整工具链解析微信视频号下载器 MCP 实战查询账号内容与浏览记录的完整工具链解析 导读 本文聚焦 wx_channels_download微信视频号下载器内置 MCP桌面应用视频网络MCP 服务微信视频号下载器 MCP 修改下载目录完整指南从 update_config 到 restart_token 确认微信视频号下载器 MCP 修改下载目录完整指南从 update_config 到 restart_token 确认 本篇技术指南聚焦于微信视频号下载器wx_桌面应用视频网络MCP 服务微信视频号下载器 MCP使用 aria2/curl 等第三方下载器保存视频号视频的完整方案微信视频号下载器 MCP使用 aria2/curl 等第三方下载器保存视频号视频的完整方案 fetch_content 解析视频号链接后会在结果中额外携带桌面应用视频网络MCP 服务上一篇Catctor图片上传与管理指南轻松实现角色素材库搭建下一篇Multik在Jupyter与Kotlin Notebook中的高效应用技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考