Kitsu MCP服务器
一 MCP（模型上下文协议） 连接克劳德等人工智能助手的服务器 Kitsu --用于动画、视觉特效和游戏工作室的开源制作管理工具。
特性
95工具 涵盖整个Kitsu生产线：
| 类别 | 工具 |
|---|---|
| 项目 | 列表、概述、统计数据、创建、关闭、添加/删除任务类型 |
| 资产 | 列表、详细信息、创建、更新、删除， 更新自定义数据、资产类型、CSV导入/导出 |
| 射击和序列 | 列表、详细信息、创建、更新、删除， 更新自定义数据、批量创建、CSV导入/导出、OTIO导入 |
| 任务 | 列表、详细信息、创建、批量创建、分配、取消分配， 启动任务, 提交审查, 更新自定义数据、更新状态、设置估计值、删除 |
| 时间追踪 | 添加、设置、获取花费的时间， 获取花费的时间范围 |
| 评论 | 添加评论， 回复评论, 确认评论，列出评论历史记录 |
| 预览 | 上传、发布、设置主界面， 按任务列出, 获取URL, 下载, 更新注释 |
| 附件 | 列出每个任务的附件文件 |
| 铸造 | 获取/设置镜头投射，获取资源投射 |
| 团队与人员 | 列出团队、更新角色、添加/删除成员、人员任务、创建人员、邀请、部门 |
| 播放列表 | 列出、创建、添加实体， 删除实体，制作电影 |
| 预算 | 列出、创建预算和预算条目 |
| 概念 | 列出、创建概念 |
| 编辑 | 列表、创建、详细信息、更新、删除、列表预览 |
| 场景 | 列出、创建场景 |
| 元数据 | 列出并添加自定义元数据描述符 |
| 通知 | 列表， 将所有标记为已读, 订阅/取消订阅任务 |
| 其他 | 搜索、任务状态、每日进度报告 |
编辑/蒙太奇审查工作流程
编辑是全长蒙太奇或序列（如动画、预告片或最终剪辑）——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配置
服务器需要三个环境变量：
| 变量 | 描述 | 示例 |
|---|---|---|
KITSU_HOST | 您的Kitsu API URL | https://kitsu.yourstudio.com/api |
KITSU_USER | 登录邮箱 | artist@yourstudio.com |
KITSU_PASSWORD | 登录密码 | your-password |
用法
使用克劳德代码
添加到您的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--预览的直接图像/视频URLget_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--将资产导出到CSVexport_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许可证——见 许可证.