mcpField
A
adapt-custom-endpoint

adapt-custom-endpoint

github.com/arcreel开发5443 次安装6 天前更新
代码仓库

关于 adapt-custom-endpoint

该 skill 使用 `scripts/custom_endpoint.py` 协助定义、验证并保存 ArcReel 的自定义 HTTP 端点，面向需要接入供应商 API 的用户。它涵盖响应检查、请求预览及经确认后进行的真实连接测试，并限制可表达的请求模式。

主要功能

  1. 01验证并保存端点定义
  2. 02检查提交与轮询响应
  3. 03预览请求及素材摘要
  4. 04经确认后测试连接
  5. 05处理凭证与覆盖确认

适用场景

  1. 01把供应商 API 转为自定义端点定义
  2. 02排查定义校验或响应格式问题
  3. 03在保存前预览并测试供应商请求

MCP 相关

该 skill 通过配置文件中的 MCP URL 派生 ArcReel API 地址，并使用 API 密钥鉴权；未说明其直接提供 MCP 服务。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arcreel/skills --skill adapt-custom-endpoint

安装后在 Claude Code 中输入/adapt-custom-endpoint确认已加载。

附带文件references/definition-format.mdscripts/custom_endpoint.py

详细介绍

来自项目 README

适配自定义调用端点

使用随 skill 提供的 scripts/custom_endpoint.py 调用 ArcReel HTTP API；共享 validator 和 API 是验证与保存定义的唯一入口。

工作流

  1. 读取用户提供的供应商文档 URL；无法读取时请用户粘贴提交、查询任务与响应示例。 确认协议属于 JSON 请求/响应的「提交后轮询」形态。签名鉴权、multipart 请求或按素材切换路由 无法由首期定义表达，直接说明缺口。
  2. 需要编写或修正定义时读取定义格式，在工作目录创建定义 JSON、 测试参数 JSON，以及供应商提供的真实响应样本。凭证优先引用 ArcReel 已保存的自定义供应商 provider_id；不得把 API Key 写入项目文件、命令参数或回复。
  3. 运行当前 skill 目录下的 scripts/custom_endpoint.py，用 validate <definition.json> 子命令校验。 修正到 errors 为空。schema_version.level 非 direct 或仍有 warnings 时，修正或向用户说明接受的原因和影响；用 hints 准备测试所需的接口地址和模型。
  4. 对供应商的提交与轮询响应分别运行 check-response；定义包含 result 时也检查取件响应。
  5. 运行 preview-request，核对 URL、method、打码后的 headers、body 与素材摘要。定义有必需素材时， 用 --start-image / --end-image / --reference-images / --reference-audio-files 附上对应文件。
  6. 测试连接会真实请求供应商并可能计费。调用前必须回问用户。 获得明确同意后才运行 trial-run ... --confirm-cost（沿用预览时的素材参数），再用 trial-status <run-id> 查询到终态， 并转述请求、响应、取值与错误。状态为 succeeded 时继续；其他终态停止，只有用户明确要求保存未验证定义时才继续。
  7. 再次 validate。没有同血统端点时用 save 新建；有重复时默认另存副本并告知用户。 只有覆盖既有端点必须回问用户；明确同意后才用 save ... --endpoint-id <id> --confirm-overwrite。保存成功以返回 ce-<id> 为完成判据。

连接

在当前工作区根目录运行脚本。脚本读取 setup-arcreel-skills 创建的 .arcreel/settings.json，从 mcp_url 派生同实例的 /api/v1 地址，并用 api_key 鉴权；配置缺失或无效时先执行 setup skill， 不回退到 localhost。

设置 ARCREEL_EMBEDDED_AGENT=1 时，脚本优先使用 ARCREEL_API_BASE 与 ARCREEL_API_TOKEN；该 JWT 有效期 15 分钟且不续期，API 调用返回 401 时告知用户重开会话获取新 token。 AUTH_ENABLED=false 的本地部署可留空 token。

评论

支持 Markdown