使用说明
# Make.com MCP服务器——使用AI构建和部署自动化场景
⚠️ 免责声明： 这是一个 非官方、社区驱动的项目 由Make.com的狂热粉丝创建 非 与Make.com有关联、得到Make.com的认可或官方支持。
A. 模型上下文协议（MCP） 为AI助手提供以下功能的服务器 克劳德, GitHub Copilot，以及 光标 完全访问Make.com模块文档、场景验证和一键部署。在40多个应用程序中搜索200多个自动化模块，构建具有自动修复功能的蓝图，并直接部署到Make.com——所有这些都可以从你的人工智能聊天中完成。
特性
- 🔍 200+模块 --在200多个Make.com模块（Slack、Gmail、Google Sheets、Notion、OpenAI和35多个应用程序）中进行全文搜索
- 📋 模块详细信息 --检索任何模块的参数、类型、描述和使用文档
- ✅ 蓝图验证 --部署前检查缺少参数、未知模块、结构问题和路由器子路由的情况
- 🛡️ 帐户感知兼容性 --在部署之前，根据您的实时Make帐户/地区验证模块ID，以防止出现“找不到模块”的情况
- 🚀 部署到Make.com -通过API将经过验证的蓝图直接推送至Make.com
- 🩹 自动修复 --自动修复LLM生成的蓝图：注入缺失
metadata，补充道designer坐标、条带不支持的属性，如路由器filter - 🔀 路由器支持 --全力支持
builtin:BasicRouter具有多条路由和递归验证 - 📚 场景模板 --浏览常见工作流的可重用场景模板
- 📖 引导提示 --MCP提示引导场景构建和模块探索
- 📊 资源目录 --用于浏览可用应用程序的MCP资源
- 🧪 43测试 --Vitest单元+集成测试套件
- ⚡ 快速响应 --使用FTS5全文搜索优化SQLite
🚀 快速入门--自助托管选项
选项A:npx（无需安装！）🚀
最快的入门方法——无需克隆，无需构建：
先决条件： Node.js 安装在您的系统上
# Run directly — no installation needed!
npx -y make-mcp-server
该软件包包括一个预构建的数据库，其中包含所有200多个Make.com模块。只需将其添加到MCP客户端配置中即可。
Claude桌面配置 (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桌面配置：
基本配置（仅限文档工具）：
{
"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"
]
}
}
}
重要提示： 这
-iMCP stdio通信需要标志。
选项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桌面配置：
{
"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 |
| 窗户 | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
更新配置后重新启动Claude Desktop。
💻 连接您的IDE
使mcp服务器与任何兼容mcp的客户端一起工作：
- 克劳德桌面 --请参阅上面的配置
- VS代码（GitHub副本） --添加到
.vscode/mcp.json - 光标 --添加到MCP设置
- 克劳德代码 --使用
claude mcp add命令 - 帆板运动 --添加到MCP配置
用法
然后问你的AI助手一些事情，比如：
“创建一个Make场景，监视Slack频道中的新消息并将其记录到Google表格中”
“Make有哪些发送电子邮件的模块？”
“验证此场景蓝图…”
提示： AI将自动调用 tools_documentation 首先要了解如何有效地使用服务器。
可用工具
| 工具 | 说明 |
|---|---|
tools_documentation |
从这里开始 --返回所有工具、提示和资源的全面文档 |
search_modules |
在Make.com的200多个模块中进行全文搜索 |
get_module |
通过参数和文档获取详细的模块信息 |
check_account_compatibility |
检查您当前的Make帐户/地区是否有可用的模块（并提供建议） |
validate_scenario |
部署前验证场景蓝图 |
create_scenario |
通过API将场景部署到Make.com |
search_templates |
搜索可重用的场景模板 |
list_apps |
列出所有具有模块计数的应用程序 |
自动修复
这 create_scenario 该工具自动修复LLM生成的蓝图中的常见问题：
| 问题 | 自动修复 |
|---|---|
失踪 metadata section |
注入完整的元数据 version, scenario 配置，以及 designer |
失踪 metadata.designer 关于模块 |
添加 { x: 0, y: 0 } 坐标 |
路由器 filter 在路线对象中 |
不支持条带 filter 属性（在Make.com UI中配置过滤器） |
失踪 version on modules |
左未设置--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）中，运行以下序列：
check_account_compatibility使用已知模块，例如。gateway:CustomWebHookvalidate_scenario用你的蓝图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）
- @模型上下文协议/sdk v1.26.0-MCP协议实现
- 更好平方3 --同步SQLite与FTS5全文搜索
- 黄道带 --工具参数的模式验证
- 轴 -用于Make.com API的HTTP客户端
- 测试 --测试框架
支持的应用程序（40+）
谷歌表格、Slack、OpenAI、谷歌云端硬盘、Notion、Telegram Bot、HubSpot CRM、Gmail、Airtable、工具、流控制、谷歌日历、Jira、Trello、Shopify、谷歌文档、微软团队、微软Outlook、Discord、Asana、monday.com、Salesforce、Stripe、GitHub、HTTP、Mailchimp、WordPress、Dropbox、Data Store、JSON、Twilio、谷歌Gemini AI、WhatsApp Business、文本解析器、Webhooks、Anthropic Claude、CSV、RSS、电子邮件、日程表
作者
由...建造 丹尼尔·沙什科
许可证
MIT许可证——见 许可证 了解详情。
