Signavio MCP Server

Signavio MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供SAP Signavio Process Manager和AI驱动的开发工具之间的无缝集成。该服务器将完整的Signavio API作为一套工具公开，使Claude、Cursor等人工智能助手和其他兼容MCP的客户端能够以编程方式与Signavio工作空间交互。

概述

Signavio MCP服务器弥合了业务流程管理和人工智能辅助开发工作流程之间的差距。无论您是自动化流程文档、管理业务流程模型、维护流程字典，还是将Signavio数据集成到开发管道中，该服务器都为所有Signavio API操作提供了统一的接口。

主要特点

• API全面覆盖：全面访问Signavio Process Manager API端点，包括模型、文件夹、字典条目和搜索功能
• AI助手集成：与Claude、Cursor和其他MCP兼容的AI开发工具无缝协作
• 业务流程自动化：自动化流程模型创建、更新、导出和管理任务
• 字典管理：创建、更新和搜索业务流程词典和术语表条目
• 多格式导出：以JSON、BPMN 2.0 XML、PNG和SVG格式导出流程模型
• 搜索功能：在模型、修订版、文件和词典条目之间进行全文搜索
• 零配置：直接与npx一起运行或在本地安装以进行开发

先决条件

• Node.js（v14或更高版本）
• npm或纱线
• 具有API访问权限的Signavio帐户
• 您的Signavio租户ID（工作区ID）

安装

选项1：使用npx（推荐）

无需安装！您可以直接使用以下命令运行MCP服务器 npx:

npx signavio-mcp

选项2：本地安装

1. 安装软件包：

   npm install signavio-mcp

1. 或者克隆存储库：

   git clone https://github.com/willpowell8/signavio-mcp.git
   cd signavio-mcp
   npm install

配置

配置环境变量：

创建一个 .env 使用您的凭据在项目根目录中创建文件：

SIGNAVIO_BASE_URL=https://api.eu.signavio.cloud.sap
SIGNAVIO_EMAIL=your-email@example.com
SIGNAVIO_PASSWORD=your-password
SIGNAVIO_TENANT=your-tenant-id

注： 基本URL是特定于区域的。使用适合您所在地区的URL：

• 欧盟： https://api.eu.signavio.cloud.sap
• 美国： https://api.us.signavio.cloud.sap
• 澳大利亚： https://api.au.signavio.cloud.sap
• 加拿大： https://api.ca.signavio.cloud.sap
• 日本： https://api.jp.signavio.cloud.sap
• 新加坡： https://api.sgp.signavio.cloud.sap
• 韩国： https://api.kr.signavio.cloud.sap

查找您的租户ID

要查找您的租户ID（工作区ID）：

1. 登录SAP Signavio Process Manager
2. 在资源管理器中，转到 帮助 菜单
3. 选择 工作区信息
4. 复制 工作区ID -这是您的租户ID

安全注意事项

• 永远不要承诺你的 .env 文件到版本控制
• 这 .env 文件应包含在 .gitignore
• 考虑将环境变量或机密管理器用于生产环境

MCP服务器配置

MCP服务器使用您的环境变量 .env 文件。您还可以：

• 在系统中设置环境变量
• 启动服务器时传递环境变量

MCP客户端配置

对于Cursor或其他MCP兼容客户端，请将以下内容添加到MCP配置中：

使用npx（推荐）：

{
  "mcpServers": {
    "signavio-api": {
      "command": "npx",
      "args": ["-y", "signavio-mcp"],
      "env": {
        "SIGNAVIO_BASE_URL": "https://api.eu.signavio.cloud.sap",
        "SIGNAVIO_EMAIL": "your-email@example.com",
        "SIGNAVIO_PASSWORD": "your-password",
        "SIGNAVIO_TENANT": "your-tenant-id"
      }
    }
  }
}

使用本地安装的软件包：

{
  "mcpServers": {
    "signavio-api": {
      "command": "node",
      "args": ["/path/to/node_modules/signavio-mcp/mcp-server.js"],
      "env": {
        "SIGNAVIO_BASE_URL": "https://api.eu.signavio.cloud.sap",
        "SIGNAVIO_EMAIL": "your-email@example.com",
        "SIGNAVIO_PASSWORD": "your-password",
        "SIGNAVIO_TENANT": "your-tenant-id"
      }
    }
  }
}

可用的MCP工具

MCP服务器提供以下工具：

认证

• signavio_authenticate -使用Signavio API进行身份验证

目录/文件夹操作

• signavio_get_root_folders -获取工作区根文件夹
• signavio_get_folder_contents -按ID获取文件夹内容
• signavio_create_folder -创建新文件夹
• signavio_update_folder -重命名或更新文件夹描述
• signavio_move_folder -将文件夹移动到新的父文件夹或回收站
• signavio_delete_folder -永久删除文件夹

词典/术语操作

• signavio_search_dictionary -搜索词典条目
• signavio_get_dictionary_entry -获取特定词典条目
• signavio_create_dictionary_entry -创建新词典条目
• signavio_update_dictionary_entry -更新词典条目
• signavio_delete_dictionary_entry -删除词典条目
• signavio_get_dictionary_categories -获取所有词典类别
• signavio_get_dictionary_category -获取特定类别
• signavio_create_dictionary_category -创建新类别

模型操作

• signavio_get_model -获取模型元数据
• signavio_get_model_revisions -获取所有模型版本
• signavio_export_model -导出模型（json、bpmn2_0_xml、png、svg）
• signavio_create_model -创建新模型/图表
• signavio_update_model -更新模型（创建新版本）
• signavio_move_model -将模型移动到其他文件夹
• signavio_publish_model -将模型发布到协作中心

搜索操作

• signavio_search -跨所有内容类型的全文搜索

运行MCP服务器

使用npx（推荐）：

npx signavio-mcp

使用本地安装的软件包：

npm start

或者直接：

node mcp-server.js

测试MCP服务器

一个全面的测试脚本可用于验证所有MCP服务器功能：

npm test

或者直接：

node test-mcp-server.js

测试脚本将：

• ✅ 测试身份验证
• ✅ 测试目录/文件夹操作（获取根文件夹，获取文件夹内容）
• ✅ 测试字典操作（类别、搜索、获取条目）
• ✅ 测试模型操作（搜索、获取模型、获取修订、导出）
• ✅ 测试搜索功能
• ✅ 提供所有测试的详细摘要

注： 测试脚本使用您的 .env 配置，如果找不到数据，将跳过需要现有数据的测试（如获取特定模型）。这是干净工作区的预期行为。

API文档

有关Signavio API的更多信息，请参阅 SAP Signavio Process Manager API指南.