自动化 MCP 服务器

这是一个模型上下文协议（MCP）服务器，提供给AI助手访问自动化工作流自动化的功能。

概述

此MCP服务器使AI助手能够与Automatisch交互，Automatisch是一个开源的Zapier替代品，用于工作流自动化。它提供了管理工作流、连接、执行和应用程序集成的工具。

功能

可用工具

• 工作流管理：创建、读取、更新、删除和测试工作流
• 连接管理：管理应用程序连接和凭据
• 执行监控：查看工作流执行历史和状态
• 应用发现：浏览可用的应用程序及其功能
• 测试：使用示例数据测试工作流

提供的资源

• 带有状态摘要的工作流概述
• 应用程序连接列表
• 可用应用程序目录
• 最近执行日志

预备条件

• Node.js 18+
• 运行中的Automatisch实例
• Automatisch API访问（推荐使用API密钥）

安装

1. 克隆或下载MCP服务器代码

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

配置

设置环境变量：

# Automatisch 实例URL（默认：http://localhost:3001）
export AUTOMATISCH_BASE_URL="http://your-automatisch-instance:3001"

# 认证API密钥（可选但推荐）
export AUTOMATISCH_API_KEY="your-api-key"

使用方法

Claude Desktop 集成

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "automatisch": {
      "command": "npx",
      "args": ["-y", "automatisch-mcp-server"],
      "env": {
        "AUTOMATISCH_BASE_URL": "http://localhost:3001",
        "AUTOMATISCH_API_KEY": "your-api-key"
      }
    }
  }
}

单独使用

npm start

可用工具

工作流管理

• list_workflows - 列出所有工作流，可选过滤
• get_workflow - 获取详细的工作流信息
• create_workflow - 创建新的工作流
• update_workflow - 更新现有工作流
• delete_workflow - 删除工作流
• test_workflow - 使用示例数据测试工作流

连接管理

• list_connections - 列出应用程序连接
• create_connection - 创建新的应用程序连接

监控与发现

• list_executions - 查看工作流执行历史
• get_available_apps - 浏览可用的应用程序和集成

示例使用与AI助手

# 列出所有活动的工作流
"显示所有活动的工作流"

# 创建一个新的工作流
"创建一个名为'电子邮件通知'的工作流，当新的GitHub问题被创建时发送电子邮件"

# 检查最近的执行
"显示最近的工作流执行及其状态"

# 获取工作流详情
"告诉我关于ID为'abc123'的工作流"

# 列出可用的应用程序
"有哪些应用程序可以进行集成？"

API 端点

服务器与这些Automatisch API端点接口：

• GET /api/flows - 列出工作流
• POST /api/flows - 创建工作流
• PATCH /api/flows/:id - 更新工作流
• DELETE /api/flows/:id - 删除工作流
• GET /api/connections - 列出连接
• POST /api/connections - 创建连接
• GET /api/executions - 列出执行
• GET /api/apps - 列出可用的应用程序

开发

在开发模式下运行

npm run dev

构建

npm run build

清理构建文件

npm run clean

错误处理

服务器包括全面的错误处理：

• 与Automatisch的网络连接问题
• 无效的API响应
• 缺少必需的参数
• 认证失败

错误会被记录并作为结构化响应返回给AI助手。

安全考虑

• 当可用时使用API密钥进行认证
• 确保Automatisch实例得到妥善保护
• 限制网络访问至可信来源
• 定期更新依赖项

故障排除

常见问题

1. 连接失败：验证AUTOMATISCH_BASE_URL是否正确且可访问
2. 认证错误：检查AUTOMATISCH_API_KEY是否有效
3. 未找到工具：确保MCP服务器已正确注册到Claude Desktop
4. API错误：检查Automatisch日志以获取详细的错误信息

调试模式

通过设置启用调试日志：

export NODE_ENV=development

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用添加测试
5. 提交拉取请求

许可证

该项目采用MIT许可证。

相关项目

• Automatisch - 开源工作流自动化
• 模型上下文协议 - 协议规范
• MCP SDK - TypeScript SDK

支持

对于以下问题：

• 与MCP服务器集成或此仓库相关的问题：在此处打开问题
• Automatisch：访问Automatisch GitHub问题
• MCP协议：查看MCP文档