Procesio MCP

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

1. 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版获得许可。请参阅 许可证 文件以获取详细信息。