Kitsu MCP Server

Kitsu MCP服务器

一 MCP（模型上下文协议） 连接克劳德等人工智能助手的服务器 Kitsu --用于动画、视觉特效和游戏工作室的开源制作管理工具。

特性

95工具 涵盖整个Kitsu生产线：

编辑/蒙太奇审查工作流程

编辑是全长蒙太奇或序列（如动画、预告片或最终剪辑）——Kitsu相当于Frame.io的基于文件的审查。上传带有音频的完整视频，并使用注释、评论和版本跟踪进行查看。

1. create_edit("My Project", "Trailer_v03")
2. create_task("My Project", "Trailer_v03", "Edit", entity_type="edit")
3. upload_preview(task_id, "/path/to/trailer_v03.mp4", comment="v3 with music")

然后，团队可以使用绘图/注释工具和时间编码注释在Kitsu的播放器中查看完整的蒙太奇。

需求

• Python 3.10+
• 跑步 Kitsu 实例（自托管或云）
• 具有适当权限的Kitsu用户帐户

安装

git clone https://github.com/INGIPSA/kitsu-mcp-server.git
cd kitsu-mcp-server
pip install -r requirements.txt

配置

服务器需要三个环境变量：

用法

使用克劳德代码

添加到您的Claude Code MCP配置中(~/.claude/mcp.json 或项目级别 .mcp.json):

{
  "mcpServers": {
    "kitsu": {
      "command": "python",
      "args": ["path/to/kitsu-mcp-server/server.py"],
      "env": {
        "KITSU_HOST": "https://kitsu.yourstudio.com/api",
        "KITSU_USER": "your-email@example.com",
        "KITSU_PASSWORD": "your-password"
      }
    }
  }
}

使用克劳德桌面

在MCP服务器下的Claude Desktop设置中添加相同的配置块。

独立

export KITSU_HOST="https://kitsu.yourstudio.com/api"
export KITSU_USER="your-email@example.com"
export KITSU_PASSWORD="your-password"

python server.py

示例提示

连接后，您可以向您的AI助手询问以下问题：

• “列出Kitsu中所有打开的项目”
• “按顺序SQ01创建镜头SH010至SH200”
• “将此渲染作为SH020上照明任务的预览上传”
• “在过去的24小时里，项目发生了什么？”
• “将SH030上的动画任务分配给anna@studio.com"
• “删除anna@studio.com来自Capsule的建模任务”
• “为今天的任务增加4小时的工作时间”
• “将所有快照导出到CSV”
• “创建新的播放列表并添加SQ01中的所有快照”
• “创建一个名为Trailer_v01的编辑，并上传蒙太奇以供审查”
• “显示编辑Animatic_v2的详细信息和预览”

可用工具

阅读

• list_projects --列出所有打开的项目
• get_project_overview --项目概述，包括团队、任务类型、资产类型
• get_project_stats --按状态分组的任务统计信息
• list_assets --列出资产（可选择按类型筛选）
• get_asset_details --包含任务的资产详细信息
• list_sequences --列出序列
• list_shots --列出快照（可选择按顺序过滤）
• get_shot_details --镜头细节，包括任务和选角
• list_my_tasks --分配给登录用户的任务
• list_tasks_for_entity --特定资源、镜头或编辑的任务
• get_task_details --带有评论历史记录的任务详细信息
• get_time_spent --任务的时间条目
• list_comments --对任务的评论
• get_shot_casting --拍摄资产明细
• get_asset_casting --拍摄出现在中的资产
• list_team_members --项目中的团队成员
• get_person_tasks --特定人员的任务
• list_departments --所有部门
• list_playlists --项目中的播放列表
• list_task_statuses --可用任务状态
• list_notifications --最近的通知
• list_preview_files_for_task --任务的所有预览文件
• list_attachment_files_for_task --任务的所有附件文件
• get_preview_file_url --预览的直接图像/视频URL
• get_time_spents_range --一个人在一个日期范围内花费的时间
• search --按名称搜索实体
• daily_progress_report --过去N小时的活动摘要
• list_concepts --项目中的概念
• list_edits --在项目中编辑
• get_edit_details --使用任务和预览编辑详细信息
• list_previews_for_edit --要编辑的所有预览文件
• list_scenes --项目中的场景
• list_metadata_descriptors --自定义元数据字段
• get_budgets --项目预算
• get_budget_entries --预算中的条目
• export_assets_csv --将资产导出到CSV
• export_shots_csv --将快照导出到CSV

创建

• create_project --创建新项目
• create_asset_type --创建资产类型
• create_asset --创建资产
• create_episode --创建一集
• create_sequence --创建序列
• create_shot --创建快照
• create_task --为资源、快照或编辑创建任务
• create_person --创建新用户
• invite_person --向用户发送邀请电子邮件
• create_department --创建一个部门
• create_playlist --创建播放列表
• create_budget --制定预算
• create_budget_entry --创建预算条目
• create_concept --创建一个概念
• create_edit --创建编辑（蒙太奇/序列供审查）
• create_scene --创建场景
• add_metadata_descriptor --添加自定义元数据字段

更新

• update_task_status --使用可选注释更改任务状态
• assign_task --指派一个人执行任务
• unassign_task --从任务中删除一个人（或清除所有受让人）
• set_task_estimate --设置任务的时间估计
• add_comment --向任务添加注释
• set_shot_casting --设置快照中显示的资源
• update_asset --更新资产描述/元数据
• update_shot --更新镜头描述/帧/元数据
• update_edit --更新编辑名称/描述
• update_team_member_role --更改团队成员的角色
• add_time_spent --增加在任务上花费的时间
• set_time_spent --设定在任务上花费的时间
• add_person_to_department --将人员添加到部门
• remove_person_from_department --从部门中删除人员
• add_entity_to_playlist --将镜头/资源添加到播放列表
• add_team_member --将人员添加到项目团队
• set_main_preview --将预览设置为主缩略图
• start_task --启动任务（设置为WIP）
• submit_for_review --提交任务供主管审查（WFA）
• reply_to_comment --对评论的线程回复
• acknowledge_comment --将评论标记为已确认
• update_asset_data --更新资产上的自定义元数据
• update_shot_data --更新快照的自定义元数据
• update_task_data --更新任务的自定义元数据
• update_preview_annotations --在预览中添加/编辑/删除注释
• mark_all_notifications_as_read --清除所有通知
• subscribe_to_task --订阅任务通知
• unsubscribe_from_task --取消订阅任务通知
• remove_entity_from_playlist --从播放列表中删除实体
• add_task_type_to_project --向项目添加任务类型
• remove_task_type_from_project --从项目中删除任务类型

批次

• batch_create_shots --一次创建多个快照（例如SH010-SH200）
• batch_create_tasks --向组中的所有快照/资源添加任务类型

预览

• upload_preview --将预览文件上传到任务
• publish_preview --状态+评论+预览一步到位
• download_preview_file --将预览文件下载到本地路径

导入/导出

• import_assets_csv --从CSV导入资产
• import_shots_csv --从CSV导入快照
• import_otio --从OpenTimelineIO导入时间线

危险（需要确认=真）

• delete_shot --删除一个镜头
• delete_asset --删除资产
• delete_task --删除任务
• delete_edit --删除编辑
• close_project --关闭/存档项目
• build_playlist_movie --从播放列表构建电影

更新日志

v0.4.0（2026-04-13）

• 任务工作流程: start_task （WIP）， submit_for_review （WFA）， reply_to_comment, acknowledge_comment
• 自定义数据: update_asset_data, update_shot_data, update_task_data --设置自定义元数据字典
• 预览文件: get_preview_file_url, download_preview_file, update_preview_annotations, list_preview_files_for_task
• 附件: list_attachment_files_for_task
• 日程: get_time_spents_range --查询日期范围内的时间条目
• 通知: mark_all_notifications_as_read, subscribe_to_task, unsubscribe_from_task
• 播放列表: remove_entity_from_playlist
• 项目: add_task_type_to_project, remove_task_type_from_project

v0.3.0（2026-04-12）

• 编辑实体支持：编辑的完整CRUD操作——创建编辑任务，通过预览获取详细信息，更新、删除
• 取消分配任务：从任务中删除特定人员或清除所有指定人员
• 编辑审核工作流：上传带有注释的完整蒙太奇/动画供团队审查（类似Frame.io）

v0.2.0版本

• 团队管理：添加/删除成员、更新角色、邀请用户
• 部门：创建、添加/删除人员
• 元数据描述符
• 预算管理
• 概念、场景、编辑（基本创建/列表）

v0.1.0

• 初始版本包含60多种工具，涵盖项目、资产、镜头、任务、预览、播放列表

许可证

MIT许可证——见 许可证.

学分

• Kitsu 通过CGWire
• 加苏 CGWire Python客户端
• 主控程序 通过Anthropic