Procesio MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，旨在与 Procesio 自动化平台 API 交互。它允许语言模型和其他 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 文件： 在项目根目录 (procesio-mcp-server/.env) 中创建一个 .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' # 或您的特定 realm（如果不同）
   

2. MCP 设置文件： 或者，直接在 MCP 客户端的设置文件（例如，cline_mcp_settings.json 或 claude_desktop_config.json）的 env 块中配置这些变量。当通过 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 请求。

许可证

该项目已获得 Apache License 2.0 许可。有关详细信息，请参阅 LICENSE 文件。