yt-playlist-organizer-mcp

工具

该服务器所做的全部工作。没有其他工具。

播放列表（/playlists）

播放列表项（/playlistItems）

此外，auth_status 用于检查配置了哪些凭据。

Related MCP server: youtube-mcp

配置

该服务器仅调用 /playlists 和 /playlistItems 端点。YouTube 数据 API 的其余部分不在范围内。

服务器读取两个环境变量：

参见 .env.example。

• 读取（..._list）仅需 API 密钥（或访问令牌）即可工作。

• 写入（insert/update/delete）和 mine=true 需要具有 youtube、youtube.force-ssl 或 youtubepartner 范围的 OAuth2 访问令牌。

获取 OAuth2 凭据

1. 在 Google Cloud Console 中创建项目。

2. 启用 YouTube Data API v3。

3. 创建 OAuth2 客户端 ID（桌面应用）并下载 JSON。

4. 将凭据交换为访问令牌（例如，通过 Python 上的 google-auth-oauthlib 或本地 OAuth 流服务）。设置 YOUTUBE_ACCESS_TOKEN=<token>。

5. （可选）创建 API 密钥以进行更简单的只读使用。

Nix

这是 NixOS 友好的。同时提供了 flake 和 shell.nix。

# Enter the dev shell (node + typescript toolchain)
nix develop

# or, non-flake:
nix-shell

构建

npm install        # install node deps (zod + MCP SDK)
npm run build      # emits dist/
npm run typecheck  # tsc --noEmit

本地运行

# Reads only (API key):
YOUTUBE_API_KEY=... node dist/index.js

# Reads + writes/mine (OAuth access token):
YOUTUBE_ACCESS_TOKEN=... node dist/index.js

接入 opencode

将以下内容添加到 ~/.config/opencode/opencode.jsonc 的 mcp 下：

"mcp": {
  "yt-playlist-organizer-mcp": {
    "type": "local",
    "command": ["node", "<path-to-repo>/dist/index.js"],
    "enabled": true,
    "environment": {
      "YOUTUBE_API_KEY": "{file:~/.secrets/yt-api-key}",
      "YOUTUBE_ACCESS_TOKEN": "{file:~/.secrets/yt-access-token}"
    }
  }
}

将 <path-to-repo> 替换为您克隆它的绝对路径，或通过 npm 安装它以按名称运行：

npm install -g .
# then use:  "command": ["yt-playlist-organizer-mcp"]

要通过 Nix shell 运行它，请使用相同的键，但更改 command：

"command": ["nix", "develop", "<path-to-repo>", "--command", "node", "dist/index.js"],

备注

• 配额成本以官方 API 文档为准，并在每个工具中记录。

• part 值会根据每个资源的有效集合进行验证。

• playlists_list / playlistItems_list 需要恰好一个过滤器参数；否则输入验证将拒绝该调用。

• 更新工具（playlists_update、playlistItems_update）会先读取现有资源，并保留任何省略的字段（例如 description、privacyStatus、position、contentDetails），而不是清除它们。因此，每次更新都会额外消耗一次读取配额。

• startAt/endAt 以秒为单位提供，并在发送到 API 之前转换为 ISO 8601 持续时间（PT1M30S）。

开发

npm install
npm test         # vitest unit tests
npm run typecheck
npm run build

许可证

MIT