调度员mcp
认证
支持两种模式-- DISPATCHARR_API_KEY 如果设置，则优先：
| 模式 | 所需变量 |
|---|---|
| API密钥（无状态，无令牌过期） | DISPATCHARR_URL + DISPATCHARR_API_KEY |
| JWT（用户名/密码） | DISPATCHARR_URL + DISPATCHARR_USERNAME + DISPATCHARR_PASSWORD |
生成API键：Dispatcharr UI→ 系统→ Users → 编辑您的用户→ 复制API密钥字段。
工具
| 域 | 工具 |
|---|---|
| 帐户/用户 | list_users, get_user, create_user, update_user, delete_user, get_current_user, update_current_user, list_user_groups, get_user_group, create_user_group, update_user_group, delete_user_group, list_permissions, list_api_keys, generate_api_key, revoke_api_key |
| 频道 | list_channels, get_channel, create_channel, update_channel, delete_channel, get_channel_streams, bulk_delete_channels, bulk_update_channels, bulk_regex_update_channels, assign_channels, batch_set_epg, match_epg_all, set_logos_from_epg, set_names_from_epg, set_tvg_ids_from_epg, create_channels_from_streams_bulk, get_channels_by_uuids, reorder_channel, set_channel_epg, match_channel_epg |
| 频道组 | list_channel_groups, create_channel_group, update_channel_group, delete_channel_group |
| 流 | list_streams, get_stream, create_channel_from_stream, create_stream, update_stream, delete_stream, bulk_delete_streams, list_stream_groups, list_stream_filter_options, list_stream_ids, get_streams_by_ids |
| 代理/实时 | get_proxy_status, get_channel_proxy_status, change_channel_stream, next_channel_stream, stop_channel_stream, stop_channel_client |
| 电子节目指南 | list_epg_sources, get_epg_source, create_epg_source, upload_epg_source, update_epg_source, delete_epg_source, list_epg_data, list_epg_programs, get_current_programs, get_epg_grid |
| M3U帐户 | list_m3u_accounts, get_m3u_account, create_m3u_account, update_m3u_account, delete_m3u_account, refresh_m3u_account, refresh_all_m3u_accounts, refresh_m3u_vod, update_m3u_group_settings, list_m3u_filters, get_m3u_filter, create_m3u_filter, update_m3u_filter, delete_m3u_filter, list_m3u_account_profiles, get_m3u_account_profile, create_m3u_account_profile, update_m3u_account_profile, delete_m3u_account_profile |
| M3U服务器组 | list_m3u_server_groups, get_m3u_server_group, create_m3u_server_group, update_m3u_server_group, delete_m3u_server_group |
| 频道配置文件 | list_channel_profiles, create_channel_profile, delete_channel_profile, get_channel_profile, update_channel_profile, duplicate_channel_profile, bulk_update_profile_channels, update_profile_channel |
| 视频点播 | list_movies, get_movie, list_series, get_series, list_episodes, list_vod_categories |
| 系统 | get_core_settings, get_version, list_stream_profiles, get_stream_profile, create_stream_profile, update_stream_profile, delete_stream_profile, get_system_events, list_timezones, list_useragents, get_useragent, create_useragent, update_useragent, delete_useragent, get_setting, update_setting, delete_setting, check_settings, get_env_settings, rehash_streams |
| 通知 | list_notifications, get_notification, get_notification_count, dismiss_notification, dismiss_all_notifications, delete_notification |
| 连接 | list_integrations, get_integration, create_integration, update_integration, delete_integration, test_integration, get_integration_subscriptions, set_integration_subscriptions, list_subscriptions, get_subscription, create_subscription, update_subscription, delete_subscription, list_stream_delivery_logs, get_delivery_log |
| 频道标识 | list_channel_logos, get_channel_logo, create_channel_logo, update_channel_logo, delete_channel_logo, bulk_delete_channel_logos, cleanup_channel_logos |
| VOD附加 | list_all_vod, get_vod_item, get_vod_category, get_episode, get_series_episodes, get_movie_provider_info, get_series_provider_info |
| VOD徽标 | list_vod_logos, get_vod_logo, create_vod_logo, update_vod_logo, delete_vod_logo, bulk_delete_vod_logos, cleanup_vod_logos |
| HDHomeRun 的 | list_hdhr_devices, get_hdhr_device, create_hdhr_device, update_hdhr_device, delete_hdhr_device |
| 代理附加功能 | change_hls_stream, get_vod_proxy_stats, stop_vod_client |
| DVR录像 | list_recordings, get_recording, schedule_recording, update_recording, delete_recording, stop_recording, extend_recording, update_recording_metadata, refresh_recording_artwork, run_comskip, bulk_delete_upcoming_recordings, get_comskip_config, update_comskip_config |
| DVR系列规则 | list_series_rules, create_series_rule, delete_series_rule, evaluate_series_rules, bulk_remove_series_rules |
| DVR重复规则 | list_recurring_rules, get_recurring_rule, create_recurring_rule, update_recurring_rule, delete_recurring_rule |
| EPG（节目） | get_epg_program, create_epg_program, update_epg_program, delete_epg_program, import_epg, get_epg_data_entry |
| 备份 | list_backups, create_backup, restore_backup, delete_backup, get_backup_schedule, update_backup_schedule, get_backup_status, get_backup_download_token |
| 插件 | list_plugins, enable_plugin, run_plugin, configure_plugin, import_plugin, reload_plugins, delete_plugin, list_plugin_repos, create_plugin_repo, update_plugin_repo, delete_plugin_repo |
待办事项
以下API终结点尚未实现。欢迎捐款。
第2层——有用的管理操作
- 文件上传 —
upload_backup,upload_channel_logo（多部分文件上传，需要不同的客户端支持）
第3级——利基市场/较低优先级
- 插件附加功能 —
refresh_plugin_repo,install_plugin,list_available_plugins,get_repo_settings,update_repo_settings,preview_plugin,get_plugin_detail（当前swagger规范中不存在）
需求
- Python 3.10+
- 正在运行的Dispatcharr实例（v0.20+）
- Dispatcharr API密钥 或 用户名+密码
安装
git clone https://github.com/YOUR_USERNAME/dispatcharr-mcp
cd dispatcharr-mcp
python3 -m venv .venv
.venv/bin/pip install -e .用法
VS代码(mcp.json)-API密钥（推荐）
{
"servers": {
"dispatcharr": {
"type": "stdio",
"command": "/path/to/dispatcharr-mcp/.venv/bin/dispatcharr-mcp",
"args": [],
"env": {
"DISPATCHARR_URL": "http://your-dispatcharr-host:9191",
"DISPATCHARR_API_KEY": "your-api-key"
}
}
}
}VS代码(mcp.json)--用户名/密码（JWT）
{
"servers": {
"dispatcharr": {
"type": "stdio",
"command": "/path/to/dispatcharr-mcp/.venv/bin/dispatcharr-mcp",
"args": [],
"env": {
"DISPATCHARR_URL": "http://your-dispatcharr-host:9191",
"DISPATCHARR_USERNAME": "mcp",
"DISPATCHARR_PASSWORD": "your-password"
}
}
}
}CLI/手动
export DISPATCHARR_URL=http://dispatcharr.local:9191
export DISPATCHARR_API_KEY=your-api-key # or use USERNAME + PASSWORD below
.venv/bin/dispatcharr-mcp环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
DISPATCHARR_URL | ✅ | Dispatcharr实例的基本URL |
DISPATCHARR_API_KEY | ✅ （或用户+通行证） | 静态API密钥-首选身份验证方法 |
DISPATCHARR_USERNAME | ✅ （或api密钥） | 取消用户名（JWT回退） |
DISPATCHARR_PASSWORD | ✅ （或api密钥） | 取消密码（JWT回退） |
许可证
麻省理工学院