Make MCP

🚀 Make.com MCP 服务器 — 使用人工智能构建和部署自动化场景

⚠️ 免责声明：这是一个由 Make.com 热情粉丝创建的 非官方、社区驱动项目。它 未与 Make.com 关联、未得到 其认可，也 未得到 其官方支持。

这是一个 模型上下文协议（MCP） 服务器，它能让 Claude、GitHub Copilot 和 Cursor 等人工智能助手全面访问 Make.com 模块文档、进行场景验证并实现一键部署。你可以在 40 多个应用程序的 200 多个自动化模块中进行搜索，使用自动修复功能构建蓝图，并直接部署到 Make.com —— 所有这些操作都可以在你的人工智能聊天界面中完成。

✨ 主要特性

• 🔍 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

# 直接运行 —— 无需安装！
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

# 构建 Docker 镜像
docker build -t make-mcp-server .

# 测试是否正常工作
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 标准输入输出通信需要 -i 标志。

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

前提条件：已安装 Node.js 和 Git

# 1. 克隆并安装
git clone https://github.com/danishashko/make-mcp.git
cd make-mcp
npm install

# 2. 构建
npm run build

# 3. 填充模块数据库（如果使用 npm 软件包，则此步骤已完成）
npm run scrape:prod

# 4. 测试是否正常工作
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 凭证是可选的。没有这些凭证，你可以访问所有文档、搜索和验证工具。有了这些凭证，你还可以获得场景部署功能。

配置文件位置

更新配置后，请重新启动 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 配置

💻 使用示例

然后你可以向你的人工智能助手提出以下问题：

"创建一个 Make 场景，用于监视 Slack 频道中的新消息并将其记录到 Google 表格中" "Make 有哪些用于发送电子邮件的模块？" "验证这个场景蓝图..."

提示：人工智能将首先自动调用 tools_documentation 以了解如何有效使用该服务器。

可用工具

自动修复

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

提示：请勿在模块上硬编码 "version": 1。某些应用程序（如 HTTP）的版本为 v4+，指定错误的版本会导致“未找到模块”错误。

MCP 提示

MCP 资源

CLI 使用方法

make-mcp-server              # 启动 MCP 服务器（标准输入输出传输）
make-mcp-server --scrape     # 填充/刷新模块数据库
make-mcp-server --version    # 打印版本
make-mcp-server --help       # 显示帮助信息

环境变量

🔧 技术细节

开发

npm run build         # 编译 TypeScript + 复制架构 + 添加 shebang
npm run build:tsc     # 仅编译 TypeScript（不打包）
npm run start:dev     # 使用 tsx 启动（无需构建）
npm run dev           # 启动并监视文件更改
npm run scrape        # 使用 tsx 填充数据库（开发环境）
npm run scrape:prod   # 从编译后的 JS 填充数据库
npm run smoke:compat  # 一键进行账户兼容性 + 验证冒烟测试
npm test              # 运行所有 43 个测试
npm run test:watch    # 以监视模式运行测试

发布到 npm

npm run prepublishOnly   # 构建 + 填充数据库 + 验证（在 npm publish 时自动运行）
npm publish              # 发布到 npm 注册表

测试

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

• 数据库测试（14 个测试） —— 插入、搜索、模板操作、FTS5 查询
• 日志记录器测试（7 个测试） —— 仅输出到标准错误、日志级别、数据序列化
• 服务器集成测试（22 个测试） —— 通过 SDK 客户端进行完整的 MCP 协议合规性测试

npm test

快速验证（2 - 3 分钟）

当你仅更改了验证/部署逻辑并希望快速确认时，可以使用此方法：

# 1) 快速回归测试
npm test

# 2) 一键冒烟测试（兼容性 + 验证）
npm run smoke:compat

# 3) （可选）手动探索 MCP
npm run start:dev

然后在你的 MCP 客户端（Claude/Cursor/Copilot）中，按以下顺序运行：

1. 使用已知模块（如 gateway:CustomWebHook）调用 check_account_compatibility
2. 使用你的蓝图调用 validate_scenario
3. 仅当兼容性良好时，调用 create_scenario

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

架构

src/
├── mcp/
│   └── server.ts          # 包含工具、提示和资源的 MCP 服务器
├── database/
│   ├── schema.sql         # SQLite + FTS5 架构
│   └── db.ts              # 数据库访问层（npx 安全路径解析）
├── scrapers/
│   └── scrape-modules.ts  # 模块数据填充（224 个模块）
└── utils/
    └── logger.ts          # 仅输出到标准错误的结构化日志记录器
bin/
├── make-mcp.js            # CLI 入口点（npx、--help、--version、--scrape）
└── postinstall.js         # 安装后验证
scripts/
├── build.js               # 构建：tsc + 复制架构 + 添加 shebang
├── prepublish.js          # 发布前准备：构建 + 填充数据库 + 验证
└── smoke-compat.js        # 快速本地冒烟测试，用于模块兼容性 + 验证
data/
└── make-modules.db        # 预构建的 SQLite 数据库（包含在 npm 软件包中）
tests/
├── database.test.ts       # 数据库单元测试（14 个）
├── logger.test.ts         # 日志记录器单元测试（7 个）
└── server.test.ts         # MCP 集成测试（22 个）
Dockerfile                 # 多阶段 Docker 镜像

技术栈

• 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 文件。