zapier-dev-mcp

Name: zapier-dev-mcp
Author: arose26

本地服务

github.com/arose26开发工具02 周前更新

代码仓库

关于 zapier-dev-mcp

zapier-dev-mcp 是面向使用 zapier-platform-cli 构建集成的开发者的 MCP 服务。它检查项目定义、排查常见的应用审核问题，并运行项目自带的验证器。

主要功能

01检查触发器、操作、身份验证和钩子
02按审核准备情况检查集成
03生成组件测试夹具和框架
04运行项目的 zapier validate 命令

适用场景

01在提交应用前审核集成
02查找缺失的示例或版本字段不一致
03为集成组件生成测试脚手架

MCP 相关

向 MCP 客户端提供集成检查、静态检查、夹具生成和验证工具。检查项目时，会在子进程中执行其入口模块。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "arose26-zapier-dev": {
      "command": "npx",
      "args": [
        "-y",
        "zapier-dev-mcp"
      ]
    }
  }
}

启动命令npx -y zapier-dev-mcp

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

安装包

npmzapier-dev-mcp0.2.0stdio

工具

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

参数	类型	必填	说明
path	string	是	zapier-platform-cli 集成项目目录的路径

详细介绍

zapier-dev-mcp

面向构建 Zapier 集成的用户提供的 MCP 服务。Zapier MCP 让 AI 使用 Zapier 应用，而此服务帮助你发布应用。将 Claude 指向你的 zapier-platform-cli 项目：

“这个集成包含什么？”——触发器、创建、搜索、身份验证、平台版本、请求钩子
“它可以提交应用审核了吗？”——通过 lint 检查，编码了 Zapier 审核中常见的集成退回原因
“运行验证器”——封装项目自带的 zapier validate

快速开始

Claude Code

claude mcp add zapier-dev -- npx -y zapier-dev-mcp

Claude Desktop——添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "zapier-dev": {
      "command": "npx",
      "args": ["-y", "zapier-dev-mcp"]
    }
  }
}

然后：“Lint C:\code\my-zapier-app，并带我逐步修复错误。”

工具

工具	功能
`inspect_integration`	应用定义的结构化摘要
`lint_integration`	审核准备情况报告：错误 / 警告 / 信息，每项都标注了组件路径
`generate_test_fixtures`	可直接运行的捆绑包模拟数据（类型化的 `inputData`、来自身份验证字段的 `authData`），以及每个组件的 appTester 测试骨架
`validate_integration`	运行项目自带的 `zapier validate`（架构 + 样式）；若缺少 CLI，则提供安装指引

Linter 检查内容

可见操作缺少 operation.sample——公开应用必须提供，也是审核中最常见的退回原因
动态下拉列表（"trigger_key.id.label"）引用了不存在的触发器
缺少 display.label / display.description / noun；输入字段没有标签
定义中的 version 与 package.json 版本不匹配；platformVersion 与 zapier-platform-core 依赖项不匹配
身份验证没有 connectionLabel（用户无法区分不同账户）
键与映射键不匹配，以及重复键

hidden 组件会跳过可见性检查。此 Linter 与 zapier validate 互为补充——架构验证会捕获格式错误的定义；此 Linter 则会捕获可以审核但不够完善的定义。

备注

检查项目时，会在子进程中执行其入口模块（并设置超时和输出上限）——这与 Zapier CLI 本身的处理方式完全相同。只将其用于你信任的项目，例如自己的项目。
无法对计算得出的输入字段（函数）进行静态 lint 检查；这类字段会被跳过，不会标记。
与 Zapier 无关联，也未获得 Zapier 认可。zapier-platform-cli 是 Zapier 的开源 SDK。

开发

npm install
npm test                 # offline tests — synthetic projects written in-suite
npm run build            # tsc → dist/
node scripts/smoke.mjs   # end-to-end: generates a project, drives the server over stdio

架构：src/extract.ts（通过子进程提取定义）和 src/lint.ts（纯审核检查）包含核心逻辑；src/index.ts 负责 MCP 接线。