关于 mcp-preflight
MCP Preflight 是一项 Agent 技能,可将 ImageKit 任务分配给合适的托管 MCP 服务及配套技能。它区分媒体库操作、账户管理、文档搜索和转换 URL 构建。
主要功能
- 01将任务分配给 DAM、Admin 或 DevTools
- 02把操作对应到服务器工具
- 03判断何时需要配套技能
- 04区分媒体、账户与 URL 任务
- 05说明 DAM 和 Admin 需分别连接
适用场景
- 01为资源搜索或上传选择服务
- 02管理来源和 URL 端点
- 03查看账户用量与分析数据
- 04查询 ImageKit 文档或构建转换 URL
MCP 相关
它根据任务指引 Agent 使用 ImageKit 托管的 DAM、Admin 和 DevTools MCP 服务。DAM 与 Admin 需要分别连接并登录 ImageKit;DevTools 无需登录。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ imagekit-developer/ skills --skill mcp-preflight安装后在 Claude Code 中输入/mcp-preflight确认已加载。
详细介绍
MCP 预检
ImageKit 提供三个托管式 MCP 服务。请根据任务选择匹配的服务。
| 任务 | 服务 | 接下来 |
|---|---|---|
| 搜索、上传、整理、添加标签、共享、元数据、集合、路径策略、公共链接、清除缓存 | DAM(https://imagekit.io/mcp/dam) | 如果任务涉及搜索、上传、共享或 AI 任务,请参阅下方的技能 |
| 来源 / 外部存储(S3、GCS、Azure、Web 服务器,……) | Admin(https://imagekit.io/mcp/admin) | list_origins、create_origin、get_origin、update_origin、delete_origin |
| URL 端点 | Admin | list_url_endpoints、create_url_endpoint、get_url_endpoint、update_url_endpoint、delete_url_endpoint |
| 账户用量总计或用量分析 | Admin | get_account_usage、get_account_usage_analytics |
| “如何……”,API/SDK 详情,某项功能是否存在 | DevTools search_docs | 请先阅读 search-docs 技能 |
| 构建转换 URL | DevTools transformation_builder | 请先阅读 transformation-builder 技能 |
| 将 ImageKit 集成到应用、CMS 或框架中 | — | 阅读 imagekit-integrations,选择 SDK/插件,然后使用 search_docs 查找详情 |
DAM 和 Admin 各自需要单独连接并登录 ImageKit。DevTools 不需要。如果缺少所需工具,说明用户尚未连接对应的服务(或尚未授予相应权限)。
技能何时真正有用
大多数 DAM 和 Admin 工具都不言自明。只有在以下情况下才需要阅读配套技能——这些工具的调用约定并非一目了然。
| 任务 | 技能 |
|---|---|
| 搜索 / 筛选 / 列出资源 | search-assets — Lucene searchQuery,且必须先发现自定义元数据字段和标签,不能凭猜测 |
| 上传文件 | upload-files — 选择器与签名上传;切勿在聊天中放入文件字节 |
| 谁可以访问文件、文件夹或集合;授予或撤销访问权限 | asset-access-control — 文件 / 文件夹 ACL 工具与集合 ACL 工具并不相同 |
| 创建或应用 AI 标记 / 元数据 / QC 工作流 | ai-tasks — 负载结构、词汇表,以及如何将它们关联到已保存的扩展 |
| 为技术栈选择 SDK、插件或小组件 | imagekit-integrations — 然后使用 search_docs 查找实现详情 |
规则
- 媒体库使用 DAM。来源、URL 端点、用量和用量分析使用 Admin。 不要在 DAM 中搜索来源或用量,也不要在 Admin 中查找文件工具。
- 切勿内联文件字节(不要使用 base64,也不要将路径作为文件内容)。请参阅
upload-files。 - 使用
search_media_library在服务端筛选搜索结果。 请参阅search-assets。 - 使用
transformation_builder,不要手动编写转换 URL。 - 编写 ImageKit 集成代码前,先使用
search_docs。 不要依赖训练数据来确定方法名或参数。如需先选择 SDK 或插件,请阅读imagekit-integrations。
评论
支持 Markdown