Procesio MCP Server

🚀 Procesio MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいており、Procesio 自動化プラットフォームの API との相互作用に使用されます。言語モデルやその他の MCP クライアントが、Procesio のワークフローとインスタンスを一覧表示、閲覧、管理できるようにします。

このサーバーは API Key/Value 認証を使用しています。

🚀 クイックスタート

Procesio MCP サーバーを使用することで、言語モデルや MCP クライアントが Procesio 自動化プラットフォームのワークフローやインスタンスを管理できます。以下では、サーバーの機能、設定方法、開発ガイドについて説明します。

✨ 主な機能

ツール

現在提供されているツールは以下の通りです。

• procesio_test_authentication：

  • 説明：現在のユーザー詳細情報を取得することで、API Key/Value 認証をテストします。
  • 入力：なし
  • 出力：認証成功後のユーザー詳細情報の 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）
  • 入力（オプション）：projectId（文字列 - プロジェクト ID、フィルタリングに使用）
  • 出力：指定されたインスタンスのステータス情報を含む JSON オブジェクト。

📦 インストール

サーバーの設定

このサーバーを設定するには、以下の手順に従ってください。

1. .env ファイルを使用した設定：

   PROCESIO_API_KEY=your_api_key_here
   PROCESIO_API_SECRET=your_api_secret_here
   

2. MCP 設定ファイルでの設定：

   {
       "procesio": {
           "apiKey": "your_api_key",
           "apiSecret": "your_api_secret"
       }
   }
   

💻 使用例

基本的な使用法

プロジェクトの一覧取得

# デフォルトのページ設定でプロジェクトを一覧表示
procesio_list_projects

特定のプロジェクトの詳細取得

# 特定のプロジェクト ID を指定して詳細を取得
procesio_get_project_details projectId=your_project_id

高度な使用法

プロジェクトの起動

# 特定のプロジェクトを起動し、ペイロードと同期実行を指定
procesio_launch_project projectId=your_project_id payload={"key": "value"} runSynchronous=true

📚 ドキュメント

開発ガイド

プロジェクトのビルド

npm install # 依存関係をインストール

ローカルでの実行

npm run build # プロジェクトをビルド
node build/index.js # サーバーを起動

サーバーは標準入出力で MCP リクエストを待ち受けます。

📄 ライセンス

このプロジェクトは、Apache ライセンス 2.0 版に基づいて公開されています。詳細については、LICENSE ファイルを参照してください。