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