{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_egqb5cpbdvf9","handle":"agentscope-media-mcp","url":"https://wellknown.network/agents/agentscope-media-mcp","links":{"self":"https://wellknown.network/agents/agentscope-media-mcp/record.json","html":"https://wellknown.network/agents/agentscope-media-mcp","markdown":"https://wellknown.network/agents/agentscope-media-mcp/record.md","api":"https://wellknown.network/api/v1/agents/agentscope-media-mcp","status":"https://wellknown.network/api/v1/agents/agentscope-media-mcp/status","claim":"https://wellknown.network/agents/agentscope-media-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/agentscope-media-mcp/claim.json","badge":"https://wellknown.network/agents/agentscope-media-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/agentscope-media-mcp/history","tools":"https://wellknown.network/api/v1/agents/agentscope-media-mcp/tools"},"ard":{"identifier":"urn:air::server:agentscope-media-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"agentscope-media-mcp","summary":"AgentScope Platform speech, image and video tools for MCP","description":"# AgentScope Media MCP\n\nPython MCP 服务：通过 AgentScope Platform 调用语音、图片、ASR 和视频模型。无网页、无本地模型、无账户 JWT 接口。\n\n**状态：开发版本。已开始真实接口联调，逐项结果见 [验证记录](docs/live-validation.md)。PyPI 尚未发布。**\n\n## 本地启动\n\n安装 uv 后，在项目目录运行：\n\n```bash\nuv sync --locked\nuv run agentscope-media-mcp\n```\n\nstdio 服务由 MCP 客户端启动；直接在终端运行时等待协议输入属于正常行为。\n密钥通过启动进程的 `AGENTSCOPE_API_KEY` 环境变量提供，不要写进源码。\n未填写密钥仍可以初始化和列出工具，调用媒体接口时会返回配置错误。\n\n本地客户端配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"agentscope-media\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"/home/fanxing/repos/agentscope-media-mcp\", \"run\", \"--locked\", \"agentscope-media-mcp\"],\n      \"env\": {\"AGENTSCOPE_API_KEY\": \"<填写模型API Key>\"}\n    }\n  }\n}\n```\n\n## 模型与工具\n\n| 工具 | 模型/功能 |\n| --- | --- |\n| list_models | 九个模型的静态清单，可按能力筛选 |\n| synthesize_speech | qwen-audio-3.0-tts-flash / qwen-audio-3.0-tts-plus |\n| generate_image / edit_image | qwen-image-3.0 |\n| transcribe_audio | qwen-audio-3.0-asr-flash |\n| generate_video | happyhorse-1.1-t2v / i2v / r2v、wan3.0-video |\n| edit_video | happyhorse-1.0-video-edit |\n| upload_media | 将 base64 data URL 上传到平台 |\n| get_task | 根据上游 task_id 查询结果 |\n\nTTS 必须指定该模型支持的 voice，避免猜测音色。Wan 文本输入已通过一次真实生成测试，其他输入模式尚未验证。\n480P、720P、1080P 可作为视频分辨率输入；实际可用性以具体模型和网关验证为准。\n图片尺寸使用 `1024*1024` 形式，不保证任意尺寸都被模型接受。\n\n## 调用流程\n\n- 配音：选择 Flash 或 Plus，填写文本和有效 voice ID，调用 synthesize_speech。\n- 图生视频：先取得公共图片 URL，再指定 happyhorse-1.1-i2v 和 image_url。\n- 参考生视频：指定 happyhorse-1.1-r2v 和 reference_urls，可在提示词中引用 [Image 1]。\n- 视频任务提交后保存 task_id，间隔查询 get_task，直到成功或失败。\n- 图片、音频结果直接返回媒体 URL 或文本；如果上游返回任务，则保留任务编号。\n\n服务不下载任意 URL，不读取调用者电脑上的路径，不永久保存作品。\nAPI 返回链接可能过期，需要由调用者及时保存。\n生成 POST 请求不自动重试；submission_unknown 表示受理结果不明，不应盲目重复生成。\n\n## 配置\n\n| 环境变量 | 默认值 |\n| --- | --- |\n| AGENTSCOPE_API_KEY | 无；生成请求必需 |\n| AGENTSCOPE_MEDIA_BASE_URL | https://platform.agentscope.io/api/v1 |\n| AGENTSCOPE_HTTP_CONCURRENCY | 4 |\n| AGENTSCOPE_CONNECT_TIMEOUT | 15 秒 |\n| AGENTSCOPE_READ_TIMEOUT | 180 秒 |\n| AGENTSCOPE_UPLOAD_MAX_BYTES | 10485760（10 MiB） |\n\n并发限制是同时进行的 HTTP 请求数，不是上游运行中的视频任务数。\n不连接 Credits、定价和用户信息接口，无费用审批。\n媒体 HTTP 客户端…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:agentscope-media-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.speech-recognition","name":"Speech Recognition","confidence":0.791,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["dev","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"agentscope-media-mcp","registry":"pypi","observedAt":"2026-10-30T19:26:43.956Z","publishedAt":"2026-10-30T10:44:03.933754Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"agentscope-media-mcp","url":"https://pypi.org/project/agentscope-media-mcp/","firstSeenAt":"2026-10-30T19:24:33.812Z","fetchedAt":"2026-10-30T19:24:33.812Z","normalizedAt":"2026-10-30T19:24:33.812Z"}]},"firstSeenAt":"2026-10-30T19:24:33.812Z","updatedAt":"2026-10-30T19:26:43.956Z"}