mcpField
M
mcp-preflight

mcp-preflight

github.com/imagekit-developerAgent 工作流2484 次安装3 周前更新
代码仓库

关于 mcp-preflight

MCP Preflight 是一项 Agent 技能,可将 ImageKit 任务分配给合适的托管 MCP 服务及配套技能。它区分媒体库操作、账户管理、文档搜索和转换 URL 构建。

主要功能

  1. 01将任务分配给 DAM、Admin 或 DevTools
  2. 02把操作对应到服务器工具
  3. 03判断何时需要配套技能
  4. 04区分媒体、账户与 URL 任务
  5. 05说明 DAM 和 Admin 需分别连接

适用场景

  1. 01为资源搜索或上传选择服务
  2. 02管理来源和 URL 端点
  3. 03查看账户用量与分析数据
  4. 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 端点Adminlist_url_endpoints、create_url_endpoint、get_url_endpoint、update_url_endpoint、delete_url_endpoint
账户用量总计或用量分析Adminget_account_usage、get_account_usage_analytics
“如何……”,API/SDK 详情,某项功能是否存在DevTools search_docs请先阅读 search-docs 技能
构建转换 URLDevTools 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 查找实现详情

规则

  1. 媒体库使用 DAM。来源、URL 端点、用量和用量分析使用 Admin。 不要在 DAM 中搜索来源或用量,也不要在 Admin 中查找文件工具。
  2. 切勿内联文件字节(不要使用 base64,也不要将路径作为文件内容)。请参阅 upload-files。
  3. 使用 search_media_library 在服务端筛选搜索结果。 请参阅 search-assets。
  4. 使用 transformation_builder,不要手动编写转换 URL。
  5. 编写 ImageKit 集成代码前,先使用 search_docs。 不要依赖训练数据来确定方法名或参数。如需先选择 SDK 或插件,请阅读 imagekit-integrations。

评论

支持 Markdown