mcpField
O
otterkit

otterkit

本地服务
otterkit.com开发工具011 周前更新

关于 otterkit

otterkit 提供 Agent Skills,指导 AI 编码 Agent 操作 OtterKit 隧道和 Webhook 端点。其工作流涵盖事件捕获、验证和重放,并支持 Stripe、GitHub、Shopify 和 Slack 的签名事件。

主要功能

  1. 01指导 Agent 管理隧道和 Webhook 端点
  2. 02捕获、检查并重放 Webhook 投递
  3. 03发送带有服务商签名的模拟事件
  4. 04根据签名密钥验证捕获的请求
  5. 05提供 Stripe、GitHub、Shopify 和 Slack 工作流

适用场景

  1. 01用模拟服务商事件测试本地 Webhook 处理程序
  2. 02检查并验证捕获的 Webhook 投递
  3. 03用更新后的签名重放捕获事件
  4. 04在 AI 编码 Agent 中配置 OtterKit 工作流

MCP 相关

OtterKit 也可通过 `claude mcp add otterkit -- npx otterkit mcp` 添加为 MCP 服务,提供与 Skills 相同的功能。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"useotterkit-otterkit": {
"command": "npx",
"args": [
"-y",
"otterkit"
]
}
}
}
启动命令npx -y otterkit

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmotterkit0.12.2

工具

11

收录的工具列表 · 更新于 3 周前

参数类型必填说明
ttlstring否例如,45m、4h、3d 后自动停止(默认 24h,最长 7d)
respondinteger否自动响应的 HTTP 状态码(默认 200)
standbyboolean否如果守护进程崩溃或断开连接,仍保持端点运行:服务器自行提供自动响应并缓冲请求(最多 200 个),重连后将请求重放到日志中。断开连接期间仍会计费。
subdomainstring否稳定的预留子域名(首次使用时绑定到帐户)
respondBodystring否自动响应正文(默认 {"received":true})

详细介绍

OtterKit Agent 技能

这些技能可教会 AI 编码 Agent(Claude Code、Cursor、Copilot——以及任何能读取 Agent Skills 格式的工具)使用 OtterKit:隧道和无服务器 Webhook 端点,支持捕获、签名验证和重放。

技能Agent 将学会什么
otterkit核心功能:隧道、Webhook 端点、捕获、检查、重放、守护进程、定价
stripe-webhooksStripe:带签名的合成事件、Stripe-Signature 验证、重新签名后重放
github-webhooksGitHub Apps:持久捕获端点、X-Hub-Signature-256 验证、重放
shopify-webhooksShopify:CLI 的稳定 --tunnel-url、HMAC 验证、备用端点
slack-webhooksSlack:通过捕获隧道接收 Events API 事件、签名密钥验证、重新签名后重放

安装(Claude Code)

将任意技能目录复制到项目中的 .claude/skills/(或复制到 ~/.claude/skills/,以供所有项目使用):

git clone https://github.com/useotterkit/skill && cp -r skill/stripe-webhooks .claude/skills/

也可以添加 OtterKit MCP 服务,它会将相同功能作为工具提供:

claude mcp add otterkit -- npx otterkit mcp

与普通隧道有何不同

每项技能都依赖三项 ngrok 同类工具不具备的功能:

  • otterkit send —— 针对本地处理程序发送带真实签名标头的合成提供商事件(stripe:payment_intent.succeeded、github:pull_request.opened 等),免费,且无需与提供商账户交互。
  • otterkit verify —— 根据签名密钥检查捕获的投递请求,逐个请求验证,并显示失败原因。
  • otterkit replay --resign —— 将捕获的事件重新投递到本地代码,并使用当前时间戳重新签名,这样能够容忍时间戳的处理程序(Stripe、Slack)仍会接受该事件。

这些技能根据 CLI 的实际实现生成,并与 CLI 同步更新。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。