Procesio MCP 服务器

这是一个设计用于与 Procesio 自动化平台 API 交互的 Model Context Protocol (MCP) 服务器。它允许语言模型和其他 MCP 客户端列出、查看和管理 Procesio 工作流及其实例。

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

功能

工具

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

• procesio_test_authentication:
  • 描述：通过获取当前用户详情来测试 API 密钥/值的身份验证。
  • 输入：无
  • 输出：成功时返回包含用户详情的 JSON 对象。
• procesio_list_projects:
  • 描述：列出可用的 Procesio 过程模板（工作流）。
  • 输入（可选）：pageNumber（整数，默认值：1），pageItemCount（整数，默认值：20）
  • 输出：包含分页过程模板列表的 JSON 对象。
• procesio_get_project_details:
  • 描述：获取特定 Procesio 过程模板（工作流）的详细信息。
  • 输入（必需）：projectId（字符串 - 过程模板的 UUID）
  • 输出：包含指定过程模板详细配置的 JSON 对象。
• procesio_launch_project:
  • 描述：启动特定 Procesio 过程模板（工作流）的一个实例。
  • 输入（必需）：projectId（字符串 - 过程模板的 UUID）
  • 输入（可选）：payload（对象），runSynchronous（布尔值），debugMode（布尔值），secondsTimeOut（整数），connectionId（字符串 - 作为头部传递）
  • 输出：包含已启动实例详细信息（例如实例 ID）的 JSON 对象。注意：如果项目无效，启动可能会失败。
• procesio_get_instance_status:
  • 描述：获取正在运行或已完成的过程实例的状态。
  • 输入（必需）：instanceId（字符串 - 过程实例的 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' # 尽管不用于身份验证，但仍需用于初始检查
   PROCESIO_PASSWORD='your_procesio_password' # 尽管不用于身份验证，但仍需用于初始检查
   PROCESIO_WEB_API_URL='https://webapi.procesio.app/' # 或您的特定实例 URL
   PROCESIO_REALM='procesio01' # 如果不同，则使用您的特定领域
   

2. MCP 设置文件：或者，在 MCP 客户端的设置文件中的 env 块中直接配置这些（例如，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

服务器将在标准 I/O 上监听 MCP 请求。

认证由 MCP Review 提供

许可证

本项目根据 Apache 许可证，版本 2.0 授权。详情请参阅 LICENSE 文件。