MediaTrack MCP（NPX Only）

最短接入方式：使用 npx 直接启动，无需 clone 项目。

1. 获取凭证

1. 打开分秒帧开放平台：https://open.mediatrack.cn/，联系在线客服咨询开通权限
2. 创建开放应用并获取：
   • MEDIATRACK_APP_ID
   • MEDIATRACK_APP_SECRET

OAuth 文档：https://open.mediatrack.cn/#/docs/api/global/oauth

2. 一行启动

MEDIATRACK_APP_ID="你的appid" \
MEDIATRACK_APP_SECRET="你的appsecret" \
MT_NOTIFY_SWITCH="on" \
MT_NOTIFY_WEBHOOK_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx" \
npx -y @mediatrack/mcp-server

3. 主流客户端接入

统一配置原则：

• command: npx
• args: -y, @mediatrack/mcp-server
• env: MEDIATRACK_APP_ID, MEDIATRACK_APP_SECRET, MT_NOTIFY_SWITCH, MT_NOTIFY_WEBHOOK_URL

OpenCode

opencode mcp add mediatrack \
  --command "npx" \
  --args "-y" \
  --args "@mediatrack/mcp-server" \
  --env MEDIATRACK_APP_ID=你的appid \
  --env MEDIATRACK_APP_SECRET=你的appsecret \
  --env MT_NOTIFY_SWITCH=on \
  --env MT_NOTIFY_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx

Claude Code

claude mcp add mediatrack \
  --command "npx" \
  --args "-y" \
  --args "@mediatrack/mcp-server" \
  --env MEDIATRACK_APP_ID=你的appid \
  --env MEDIATRACK_APP_SECRET=你的appsecret \
  --env MT_NOTIFY_SWITCH=on \
  --env MT_NOTIFY_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx

Claude Desktop / Cursor / Cline / Continue / Windsurf

多数客户端都支持 mcpServers 配置，可用如下模板（字段名按客户端版本微调）：

{
  "mcpServers": {
    "mediatrack": {
      "command": "npx",
      "args": ["-y", "@mediatrack/mcp-server"],
      "env": {
        "MEDIATRACK_APP_ID": "你的appid",
        "MEDIATRACK_APP_SECRET": "你的appsecret",
        "MT_NOTIFY_SWITCH": "on",
        "MT_NOTIFY_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"
      }
    }
  }
}

4. 快速验收

• 请列出我的所有项目
• 在项目“<项目名>”里搜索 <关键词>
• 获取资产 <资产ID> 的下载链接
• 把项目 <项目ID> 的 <文件夹名> 文件夹下载到 ~/Downloads