AI导哈

工作流管理服务器

Procesio MCP Server是一个用于与Procesio自动化平台API交互的模型上下文协议服务器，支持语言模型和其他MCP客户端列出、查看和管理Procesio工作流和实例。

  • by serenichron
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 serenichron/procesio-mcp-server

使用说明

Procesio MCP服务器

这是一个模型上下文协议（MCP）服务器，旨在与 进程 自动化平台API。它允许语言模型和其他MCP客户端列出、查看和管理Procesio工作流和实例。

此服务器使用API密钥/值身份验证。

特性

工具

服务器目前提供以下工具：

  • procesio_test_authentication:
    • 说明：通过获取当前用户详细信息来测试API密钥/值身份验证。
    • 输入：无
    • 输出：JSON对象，成功时包含用户详细信息。
  • procesio_list_projects:
    • 说明：列出可用的Procesio流程模板（工作流）。
    • 输入（可选）： pageNumber （整数，默认值：1）， pageItemCount （整数，默认值：20）
    • 输出：JSON对象，包含一个分页的流程模板列表。
  • procesio_get_project_details:
    • 描述：获取特定Procesio流程模板（工作流）的详细信息。
    • 输入（必填）： projectId （string-流程模板的UUID）
    • 输出：具有指定流程模板详细配置的JSON对象。
  • procesio_launch_project:
    • 描述：启动特定Procesio流程模板（工作流）的实例。
    • 输入（必填）： projectId （string-流程模板的UUID）
    • 输入（可选）： payload （对象）， runSynchronous （布尔值）， debugMode （布尔值）， secondsTimeOut （整数）， connectionId （字符串-作为标头传递）
    • 输出：JSON对象，包含启动实例的详细信息（例如实例ID）。 注意：如果项目无效，启动可能会失败。
  • procesio_get_instance_status:
    • 描述：获取正在运行或已完成的流程实例的状态。
    • 输入（必填）： instanceId （string-流程实例的UUID）
    • 输入（可选）： flowTemplateId （字符串-原始模板的UUID）， isArchived （布尔值）
    • 输出：包含指定实例状态详细信息的JSON对象。

配置

此服务器要求为身份验证和API终结点配置设置环境变量。这些可以通过以下方式提供：

  1. .env 文件： 创建一个 .env 项目根目录中的文件(procesio-mcp-server/.env)内容如下：

    PROCESIO_API_KEY='YOUR_API_KEY'
PROCESIO_API_VALUE='YOUR_API_VALUE'
PROCESIO_USERNAME='your_procesio_username' # Still needed for initial check, though not used for auth
PROCESIO_PASSWORD='your_procesio_password' # Still needed for initial check, though not used for auth
PROCESIO_WEB_API_URL='https://webapi.procesio.app/' # Or your specific instance URL
PROCESIO_REALM='procesio01' # Or your specific realm if different

  2. MCP设置文件： 或者，直接在 env MCP客户端设置文件的块（例如。， cline_mcp_settings.json 或 claude_desktop_config.json).当通过MCP客户端运行时，此方法是首选，因为它可以确保变量正确传递给服务器进程。

    {
  "mcpServers": {
    "procesio": {
      "command": "node",
      "args": [
        "/path/to/procesio-mcp-server/build/index.js"
      ],
      "env": {
        "PROCESIO_API_KEY": "YOUR_API_KEY",
        "PROCESIO_API_VALUE": "YOUR_API_VALUE",
        "PROCESIO_USERNAME": "your_procesio_username",
        "PROCESIO_PASSWORD": "your_procesio_password",
        "PROCESIO_WEB_API_URL": "https://webapi.procesio.app/",
        "PROCESIO_REALM": "procesio01"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

    替换 /path/to/ 以及服务器目录的实际路径。

发展

需要Node.js（建议使用LTS版本，请参阅 .nvmrc).

安装依赖项：

npm install

构建服务器：

npm run build

对于自动重建的开发：

npm run watch

本地运行（用于测试）

确保设置了环境变量（例如，通过 .env 或导出到您的shell中）。

npm run build
node build/index.js

服务器将在stdio上监听MCP请求。

认证人 MCP审查

许可证

此项目根据Apache许可证2.0版获得许可。请参阅 许可证 文件以获取详细信息。

相关 MCP