make-mcp

Make.com MCP 服务 — 使用 AI 构建和部署自动化场景

⚠️ 免责声明： 这是一个由热情的 Make.com 粉丝创建的非官方社区项目。本项目与 Make.com 无关，也未获其认可或官方支持。

一个 Model Context Protocol (MCP) 服务，让 Claude、GitHub Copilot 和 Cursor 等 AI 助手可以全面访问 Make.com 模块文档、场景验证和一键部署功能。搜索 40 多款应用中的 200 多个自动化模块，构建可自动修复的蓝图，并直接部署到 Make.com——所有操作都可在 AI 聊天中完成。

功能

• 🔍 200 多个模块 — 对 200 多个 Make.com 模块进行全文搜索（Slack、Gmail、Google Sheets、Notion、OpenAI，以及另外 35 多款应用）
• 📋 模块详情 — 获取任意模块的参数、类型、说明和用法文档
• ✅ 蓝图验证 — 部署前检查场景是否缺少参数、包含未知模块、存在结构问题或路由器子路由问题
• 🛡️ 账户感知兼容性检查 — 部署前根据你的实时 Make 账户／区域验证模块 ID，避免出现“找不到模块”的情况
• 🚀 部署到 Make.com — 通过 API 将已验证的蓝图直接推送到 Make.com
• 🩹 自动修复 — 自动修复由大模型生成的蓝图：注入缺失的 metadata、添加 designer 坐标，并移除路由器 filter 等不受支持的属性
• 🔀 路由器支持 — 全面支持包含多条路由的 builtin:BasicRouter，并可递归验证
• 📚 场景模板 — 浏览适用于常见工作流的可复用场景模板
• 📖 引导式提示词 — 提供 MCP 提示词，引导构建场景和探索模块
• 📊 资源目录 — 提供 MCP 资源，供浏览可用应用
• 🧪 43 项测试 — 使用 Vitest 的单元测试和集成测试套件
• ⚡ 快速响应 — 使用经过优化的 SQLite 和 FTS5 全文搜索

---

🚀 快速开始 — 自托管选项

选项 A：npx（无需安装！）🚀

最快的入门方式——无需克隆或构建：

前置条件： 系统已安装 Node.js

# Run directly — no installation needed!
npx -y make-mcp-server

此软件包包含一个预构建数据库，其中包含全部 200 多个 Make.com 模块。只需将其添加到 MCP 客户端配置即可开始使用。

Claude Desktop 配置（claude_desktop_config.json）：

基本配置（仅文档工具）：

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "npx",
      "args": ["-y", "make-mcp-server"],
      "env": {
        "LOG_LEVEL": "error"
      }
    }
  }
}

完整配置（含 Make.com 部署功能）：

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "npx",
      "args": ["-y", "make-mcp-server"],
      "env": {
        "LOG_LEVEL": "error",
        "MAKE_API_KEY": "your_api_key_here",
        "MAKE_TEAM_ID": "your_team_id",
        "MAKE_API_URL": "https://eu1.make.com/api/v2"
      }
    }
  }
}

注意： npx 会自动下载并缓存最新版本。此软件包包含预构建数据库，其中收录了所有 Make.com 模块信息——无需任何设置。

---

选项 B：Docker（隔离且可复现）🐳

前置条件： 系统已安装 Docker

# Build the Docker image
docker build -t make-mcp-server .

# Test it works
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}},"id":1}' | docker run -i --rm make-mcp-server

Claude Desktop 配置：

基本配置（仅文档工具）：

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "LOG_LEVEL=error",
        "make-mcp-server"
      ]
    }
  }
}

完整配置（含 Make.com 部署功能）：

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "LOG_LEVEL=error",
        "-e", "MAKE_API_KEY=your_api_key_here",
        "-e", "MAKE_TEAM_ID=your_team_id",
        "-e", "MAKE_API_URL=https://eu1.make.com/api/v2",
        "make-mcp-server"
      ]
    }
  }
}

重要： MCP 的 stdio 通信必须使用 -i 标志。

---

选项 C：本地安装（用于开发）🛠️

前置条件： Node.js 和 Git

# 1. Clone and install
git clone https://github.com/danishashko/make-mcp.git
cd make-mcp
npm install

# 2. Build
npm run build

# 3. Populate the module database (already done if using npm package)
npm run scrape:prod

# 4. Test it works
npm start

Claude Desktop 配置：

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/make-mcp/dist/mcp/server.js"],
      "env": {
        "LOG_LEVEL": "error",
        "MAKE_API_KEY": "your_api_key_here",
        "MAKE_TEAM_ID": "your_team_id"
      }
    }
  }
}

注意： Make.com API 凭据为可选项。不配置凭据时，你仍可使用所有文档、搜索和验证工具。配置凭据后，还可获得场景部署功能。

---

配置文件位置

平台	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

更新配置后，请重启 Claude Desktop。

---

💻 连接 IDE

make-mcp-server 适用于任何兼容 MCP 的客户端：

• Claude Desktop — 请参阅上方的配置
• VS Code (GitHub Copilot) — 添加到 .vscode/mcp.json
• Cursor — 添加到 MCP 设置
• Claude Code — 使用 claude mcp add 命令
• Windsurf — 添加到 MCP 配置

---

使用方法

然后向 AI 助手提出类似这样的问题：

“创建一个 Make 场景，监视 Slack 频道中的新消息，并将其记录到 Google Sheet”

“Make 有哪些用于发送电子邮件的模块？”

“验证此场景蓝图……”

提示： AI 会先自动调用 tools_documentation，了解如何有效使用此服务。

可用工具

工具	描述
tools_documentation	从这里开始 — 返回所有工具、提示词和资源的完整文档
search_modules	对 200 多个 Make.com 模块进行全文搜索
get_module	获取模块的详细信息，包括参数和文档
check_account_compatibility	检查当前 Make 账户/区域是否提供这些模块（并提供建议）
validate_scenario	在部署前验证场景蓝图
create_scenario	通过 API 将场景部署到 Make.com
search_templates	搜索可复用的场景模板
list_apps	列出所有应用及其模块数量

自动修复

create_scenario 工具会自动修复大模型生成的蓝图中的常见问题：

问题	自动修复
缺少 metadata 部分	注入包含 version、scenario 配置和 designer 的完整元数据
模块缺少 metadata.designer	添加 { x: 0, y: 0 } 坐标
路由对象中的路由器 filter	移除不受支持的 filter 属性（请在 Make.com UI 中配置过滤器）
模块缺少 version	保持未设置 — Make.com 会自动解析最新安装版本
目录不匹配（IM007，模块不可用）	检查账户/区域中的实时模块，自动重新映射相近模块，并重试部署一次

提示： 不要在模块上硬编码 "version": 1。某些应用（例如 HTTP）使用的是 v4 或更高版本，指定错误版本会导致“找不到模块”错误。

MCP 提示词

提示词	描述
build_scenario	根据自然语言描述创建 Make.com 场景的引导式工作流
explain_module	获取任意 Make.com 模块的详细说明和使用示例

MCP 资源

资源 URI	描述
make://apps	列出所有可用应用及其模块数量

CLI 用法

make-mcp-server              # Start the MCP server (stdio transport)
make-mcp-server --scrape     # Populate/refresh the module database
make-mcp-server --version    # Print version
make-mcp-server --help       # Show help

环境变量

变量	必需	默认值	描述
MAKE_API_KEY	部署时必需	—	Make.com API 密钥
MAKE_API_URL	否	https://eu1.make.com/api/v2	Make.com API 基础 URL
MAKE_TEAM_ID	部署时必需	—	用于部署场景的默认团队 ID
DATABASE_PATH	否	<package>/data/make-modules.db	SQLite 数据库文件路径
LOG_LEVEL	否	info	日志级别：debug、info、warn、error、silent
MAKE_MODULE_CACHE_TTL_MS	否	300000	实时模块目录检查的缓存 TTL（毫秒）

开发

npm run build         # Compile TypeScript + copy schema + add shebang
npm run build:tsc     # TypeScript only (no packaging)
npm run start:dev     # Start with tsx (no build needed)
npm run dev           # Start with file watching
npm run scrape        # Populate DB with tsx (dev)
npm run scrape:prod   # Populate DB from compiled JS
npm run smoke:compat  # One-command account compatibility + validation smoke check
npm test              # Run all 43 tests
npm run test:watch    # Run tests in watch mode

发布到 npm

npm run prepublishOnly   # Build + populate DB + verify (runs automatically on npm publish)
npm publish              # Publish to npm registry

测试

测试套件包含 3 个文件中的 43 项测试：

• 数据库测试（14 项）— 插入、搜索、模板操作、FTS5 查询
• 日志记录器测试（7 项）— 仅向 Stderr 输出、日志级别、数据序列化
• 服务集成测试（22 项）— 通过 SDK 客户端全面验证 MCP 协议合规性

npm test

快速验证（2-3 分钟）

在刚修改验证/部署逻辑后，想快速确认时使用：

# 1) Fast regression check
npm test

# 2) One-command smoke check (compatibility + validation)
npm run smoke:compat

# 3) (Optional) Manual MCP exploration
npm run start:dev

然后在 MCP 客户端（Claude/Cursor/Copilot）中按以下顺序操作：

1. 使用已知模块运行 check_account_compatibility，例如 gateway:CustomWebHook
2. 使用你的蓝图运行 validate_scenario
3. 仅当兼容性检查通过时运行 create_scenario

如果第 1 步报告模块不兼容，请在部署前使用建议的替代 ID。

架构

src/
├── mcp/
│   └── server.ts          # MCP server with tools, prompts, resources
├── database/
│   ├── schema.sql         # SQLite + FTS5 schema
│   └── db.ts              # Database access layer (npx-safe path resolution)
├── scrapers/
│   └── scrape-modules.ts  # Module data population (224 modules)
└── utils/
    └── logger.ts          # Structured stderr-only logger
bin/
├── make-mcp.js            # CLI entry point (npx, --help, --version, --scrape)
└── postinstall.js         # Post-install verification
scripts/
├── build.js               # Build: tsc + copy schema + add shebang
├── prepublish.js          # Publish prep: build + populate DB + verify
└── smoke-compat.js        # Fast local smoke test for module compatibility + validation
data/
└── make-modules.db        # Pre-built SQLite database (bundled in npm package)
tests/
├── database.test.ts       # Database unit tests (14)
├── logger.test.ts         # Logger unit tests (7)
└── server.test.ts         # MCP integration tests (22)
Dockerfile                 # Multi-stage Docker image

技术栈

• TypeScript + Node.js（ESM）
• @modelcontextprotocol/sdk v1.26.0 — MCP 协议实现
• better-sqlite3 — 支持 FTS5 全文搜索的同步 SQLite
• zod — 工具参数的架构验证
• axios — Make.com API 的 HTTP 客户端
• vitest — 测试框架

支持的应用（40+）

Google Sheets、Slack、OpenAI、Google Drive、Notion、Telegram Bot、HubSpot CRM、Gmail、Airtable、Tools、Flow Control、Google Calendar、Jira、Trello、Shopify、Google Docs、Microsoft Teams、Microsoft Outlook、Discord、Asana、monday.com、Salesforce、Stripe、GitHub、HTTP、Mailchimp、WordPress、Dropbox、Data Store、JSON、Twilio、Google Gemini AI、WhatsApp Business、Text Parser、Webhooks、Anthropic Claude、CSV、RSS、Email、Schedule

作者

由 Daniel Shashko 构建

许可证

MIT 许可证 — 详情请见 LICENSE。