open-index/open-npm huggingface dataset:
npm package: @mediatrack/mcp-server
Description: MediaTrack MCP Server
Latest version: 0.1.0

# 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. 一行启动

```bash
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

```bash
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

```bash
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` 配置，可用如下模板（字段名按客户端版本微调）：

```json
{
  "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`
npm package: @mediatrack/open-asset
Description: 文档见 [分秒帧开放平台](https://open.mediatrack.cn/#/docs/api/jssdk/upload)
Latest version: 0.0.3

# 分秒帧开放平台 上传 SDK

文档见 [分秒帧开放平台](https://open.mediatrack.cn/#/docs/api/jssdk/upload)
npm package: @mediatrack/open-player
Description: 文档见 [分秒帧开放平台](https://open.mediatrack.cn/#/docs/api/jssdk/player)
Latest version: 0.0.2

# 分秒帧开放平台 播放器 SDK

文档见 [分秒帧开放平台](https://open.mediatrack.cn/#/docs/api/jssdk/player)