ガムループ MCP サーバー

Gumloop の API 用の MCP サーバー。AI モデルが標準化されたインターフェースを通じて自動化を管理および実行できるようにします。

特徴

• フロー管理:自動化を開始し、その実行ステータスを監視する

• ワークスペースの検出: 利用可能なワークブックと保存された自動化フローを一覧表示します

• 入力スキーマの取得:フローに必要な入力に関する詳細情報を取得します

• ファイル操作:自動化で使用されるファイルのアップロードとダウンロード

• コンテキスト認識実行: ユーザーのニーズに合わせた入力パラメータを使用して自動化を実行します。

Related MCP server: The Web MCP

ツール

startAutomation

特定の保存された自動化に対して新しいフロー実行を開始します。

入力:

• user_id (文字列): フローを開始したユーザーのID

• saved_item_id (文字列): 保存されたフローのID

• project_id (文字列、オプション): フローが実行されるプロジェクトのID

• pipeline_inputs (配列、オプション): フローの入力のリスト

  • input_name (文字列): 入力ノードの「input_name」パラメータ

  • value (文字列): 入力ノードに渡される値

戻り値: run_id、saved_item_id、workbook_id、URL などの実行詳細を含む応答

retrieveRunDetails

特定のフロー実行に関する詳細を取得します。

入力:

• run_id (文字列): 取得するフロー実行のID

• user_id (文字列、オプション): フローを開始するユーザーのID

• project_id (文字列、オプション): フローが実行されるプロジェクトのID

**戻り値:**状態、出力、タイムスタンプ、ログなどの実行の詳細を含む応答

listSavedFlows

ユーザーまたはプロジェクトの保存されているすべてのフローのリストを取得します。

入力:

• user_id (文字列、オプション): アイテムを一覧表示するユーザーID

• project_id (文字列、オプション): 項目を一覧表示するプロジェクトID

**戻り値:**保存されたフローのリストとそのメタデータを含む応答

listWorkbooks

すべてのワークブックとそれに関連付けられた保存済みフローのリストを取得します。

入力:

• user_id (文字列、オプション): ワークブックを一覧表示するユーザーID

• project_id (文字列、オプション): ワークブックを一覧表示するプロジェクトID

**戻り値:**ワークブックとそれに関連付けられた保存済みフローのリストを含む応答

retrieveInputSchema

特定の保存されたフローの入力スキーマを取得します。

入力:

• saved_item_id (文字列): 入力スキーマを取得する保存済みアイテムのID

• user_id (文字列、オプション): フローを作成したユーザーID

• project_id (文字列、オプション): フローが属するプロジェクトID

**戻り値:**フローの入力パラメータのリストを含む応答

uploadFile

単一のファイルを Gumloop プラットフォームにアップロードします。

入力:

• file_name (文字列): アップロードするファイルの名前

• file_content (文字列): Base64でエンコードされたファイルの内容

• user_id (文字列、オプション): ファイルに関連付けられたユーザーID

• project_id (文字列、オプション): ファイルに関連付けられたプロジェクトID

**戻り値:**成功ステータスとファイル名を含む応答

uploadMultipleFiles

1 回のリクエストで複数のファイルを Gumloop プラットフォームにアップロードします。

入力:

• files (配列): アップロードするファイルオブジェクトの配列

  • file_name (文字列): アップロードするファイルの名前

  • file_content (文字列): Base64でエンコードされたファイルの内容

• user_id (文字列、オプション): ファイルに関連付けられたユーザーID

• project_id (文字列、オプション): ファイルに関連付けられたプロジェクトID

**戻り値:**成功ステータスとアップロードされたファイル名のリストを含む応答

downloadFile

Gumloop プラットフォームから特定のファイルをダウンロードします。

入力:

• file_name (文字列): ダウンロードするファイルの名前

• run_id (文字列): ファイルに関連付けられたフロー実行のID

• saved_item_id (文字列): ファイルに関連付けられた保存されたアイテムID

• user_id (文字列、オプション): フロー実行に関連付けられたユーザーID

• project_id (文字列、オプション): フロー実行に関連付けられたプロジェクトID

**戻り値:**要求されたファイルの内容

downloadMultipleFiles

Gumloop プラットフォームから複数のファイルを zip アーカイブとしてダウンロードします。

入力:

• file_names (配列): ダウンロードするファイル名の配列

• run_id (文字列): ファイルに関連付けられたフロー実行のID

• user_id (文字列、オプション): ファイルに関連付けられたユーザーID

• project_id (文字列、オプション): ファイルに関連付けられたプロジェクトID

• saved_item_id (文字列、オプション): ファイルに関連付けられた保存済みアイテムID

**戻り値:**要求されたファイルを含む Zip ファイル

設定

APIキー

必要な機能にアクセスできる Gumloop API キーを作成します。

1. Gumloopワークスペース設定に移動

2. 新しいAPIキーを生成する

3. 生成されたキーをコピーする

Claude Desktopでの使用

Claude Desktop でこれを使用するには、 claude_desktop_config.jsonに以下を追加します。

NPXの使用

{
  "mcpServers": {
    "gumloop": {
      "command": "npx",
      "args": [
        "-y",
        "gumloop-mcp-server"
      ],
      "env": {
        "GUMLOOP_API_KEY": "<YOUR_GUMLOOP_API_KEY>"
      }
    }
  }
}

Dockerの使用

{
  "mcpServers": {
    "gumloop": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUMLOOP_API_KEY",
        "gumloop-mcp-server"
      ],
      "env": {
        "GUMLOOP_API_KEY": "<YOUR_GUMLOOP_API_KEY>"
      }
    }
  }
}

例

自動化の開始

// Start a saved automation flow
const result = await agent.callTool("startAutomation", {
  user_id: "user123",
  saved_item_id: "flow456",
  pipeline_inputs: [
    {
      input_name: "search_query",
      value: "AI automation trends 2025"
    }
  ]
});

実行ステータスの確認

// Check the status of a running automation
const result = await agent.callTool("retrieveRunDetails", {
  run_id: "run789",
  user_id: "user123"
});

利用可能なフローの一覧表示

// Get all saved flows for a user
const result = await agent.callTool("listSavedFlows", {
  user_id: "user123"
});

ファイルの操作

// Upload a file to be used in an automation
const result = await agent.callTool("uploadFile", {
  user_id: "user123",
  file_name: "data.csv",
  file_content: "base64EncodedFileContent..."
});

応答フォーマット

サーバーはGumloop APIレスポンスをJSON形式で返します。実行の詳細を取得する例を以下に示します。

{
  "user_id": "user123",
  "state": "RUNNING",
  "outputs": {},
  "created_ts": "2023-11-07T05:31:56Z",
  "finished_ts": null,
  "log": [
    "Starting automation flow...",
    "Processing input parameters...",
    "Executing node 1: Web Scraper..."
  ]
}

制限事項

• API呼び出しはGumloopのレート制限と使用量制限の対象となります

• ファイルのアップロードは、Gumloop の API で許可されている最大サイズに制限されます。

• 一部の機能には特定のサブスクリプションプランが必要となる場合があります

• サーバーには、適切な権限を持つ有効なGumloop APIキーが必要です。

建てる

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Start the server
pnpm start

ライセンス

この MCP サーバーは MIT ライセンスに基づいてライセンスされます。