MCP Connector

Orchestrate iFlytek Workflows via MCP

MCP server calling iFlytek workflows - sequential, parallel, loop, and nested execution across 14 node types.

Works with github

Maintainer of this project? Claim this page to edit the listing.


91
Spark score
out of 100
Updated Mar 2025
Version 1.0.0
Models
universal

Add to Favorites

Why it matters

Integrate iFlytek's intelligent workflow orchestration capabilities into your existing MCP-based systems. This asset enables seamless calling of complex iFlytek workflows, supporting a wide range of node types and execution modes for sophisticated automation.

Outcomes

What it gets done

01

Connect to iFlytek's workflow engine using MCP tools.

02

Execute 14+ node types including logic and transformation.

03

Manage sequential, parallel, and nested workflow execution.

04

Handle complex variable input/output for data transfer.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-iflytek-workflow | bash

Capabilities

Tools your agent gets

call_workflow

Execute an iFlytek workflow with support for sequential, parallel, cyclic, and nested execution modes.

list_workflows

List all available iFlytek workflows configured in the system.

get_workflow_status

Get the current execution status of a running or completed workflow.

Overview

iFlytek Workflow MCP Server

An MCP server calling pre-built iFlytek Xinghuo workflows, supporting sequential, parallel, looped, and nested orchestration across 14 node types with multi-model support. Use when an AI application needs to trigger and orchestrate existing iFlytek Xinghuo workflows through a standard MCP interface.

What it does

This is an MCP server implementation using iFlytek's Xinghuo (Spark) platform, enabling AI applications to call iFlytek workflows through MCP tools for intelligent workflow scheduling across business scenarios. A workflow is composed of multiple nodes across 14 supported types (basic, tool, logic, and transformation), with a default Start Node (user input) and End Node (output result); once triggered, it executes automatically per predefined sequence and rules with no manual intervention required.

When to use - and when NOT to

Use this connector when an AI application needs to trigger and run pre-built iFlytek workflows - sequential, parallel, looped, or nested - rather than reimplementing that orchestration logic itself. Core capabilities include robust node support (14 node types, complex variable I/O for flexible data transmission) and advanced orchestration modes: sequential execution (tasks run one after another), parallel execution (multiple tasks run simultaneously for efficiency), loop execution (iterative loops for repetitive tasks), nested execution (embedding sub-workflows for reusability), and a hook mechanism enabling streaming output for real-time processing. Supported development paradigms span single-turn single-branch (linear), single-turn multi-branch (branching logic), single-turn loop, and multi-turn interaction (context memory for dynamic conversations). Capability expansion includes multi-model support via a "Model of Models" hybrid application architecture, offering multiple model choices at critical workflow stages for flexible model combinations.

Inputs and outputs

Usage requires a config.yaml describing each workflow: a required flow_id, an optional name and description (fetched from the cloud if unset), and a required api_key in "API Key:API Secret" format. Workflow authentication is obtained by creating a bot on the Xinghuo platform, debugging the workflow, confirming a successful test conversation, publishing it, selecting "Publish as API" and clicking "Configure", then binding it to an application to retrieve the workflow ID and authentication info (apply for app access at xfyun.cn if no app is selectable).

Integrations

For persistent MCP client use, add an entry to claude_desktop_config.json or mcp.json running via uvx --from git+https://github.com/iflytek/ifly-workflow-mcp-server ifly_workflow_mcp_server, with a CONFIG_PATH environment variable pointing at the prepared config.yaml (e.g. /Users/hygao1024/Projects/config.yaml in the documented example). This server is MIT-licensed.

Who it's for

Teams already building automated business workflows on iFlytek's Xinghuo platform who want an AI application to trigger and orchestrate those workflows - including parallel, looped, nested, and multi-model steps - through a standard MCP interface. Since the config format supports multiple workflow entries in one file, an assistant can be wired up to call several distinct Xinghuo workflows through the same MCP server rather than needing a separate server instance per workflow, which matters for teams managing more than one published bot at a time.

Source README

The fastest way to build workflows with an AI agent platform!

License | Docs | Homepage

iFlytek Workflow MCP Server

The Model Context Protocol (MCP) is an open protocol designed for effortless integration between LLM applications and external data sources or tools, offering a standardized framework to seamlessly provide LLMs with the context they require.

This a simple implementation of an MCP server using iFlytek. It enables calling iFlytek workflows through MCP tools.

Features

Functional Overview

This system is built on the iFlytek MCP server and enables intelligent workflow scheduling, making it suitable for various business scenarios.

  • Workflow Structure: Composed of multiple nodes, supporting 14 types of nodes (including basic, tool, logic, and transformation types).
  • Core Components: By default, the workflow includes a Start Node (user input) and an End Node (output result).
  • Execution Mode: Once triggered, the workflow executes automatically according to predefined sequences and rules, requiring no manual intervention.

Core Capabilities

Robust Node Support
  • 14 types of workflow nodes to meet diverse business requirements.
  • Supports complex variable I/O, enabling flexible data transmission.
Advanced Orchestration Modes
  • Sequential Execution: Tasks execute one after another in order.
  • Parallel Execution: Multiple tasks run simultaneously to enhance efficiency.
  • Loop Execution: Supports iterative loops for handling repetitive tasks.
  • Nested Execution: Allows embedding sub-workflows within workflows, improving reusability.
  • Utilizes the Hook Mechanism to enable streaming output, ensuring real-time processing.
Multiple Development Paradigms
  • Single-turn, single-branch: Linear execution of simple tasks.
  • Single-turn, multi-branch: Supports branching logic to handle complex processes.
  • Single-turn loop: Manages looped tasks to enhance automation.
  • Multi-turn interaction: Supports context memory for dynamic conversations.

Capability Expansion

  • Multi-Model Support: Based on the Model of Models (MoM) hybrid application architecture, providing multiple model choices at critical workflow stages. This allows for flexible model combinations, improving task adaptability.

Usage with MCP client

Prepare config.yaml

Before using the mcp server, you should prepare a config.yaml to save your workflow info. The example config like this:

- flow_id: 'flow id'              # required
  name: 'flow name'               # optional, if not set, obtain the name from the cloud.
  description: 'flow description' # optional, if not set, obtain the description from the cloud.
  api_key: 'API Key:API Secret'   # required
Get workflow authentication information
  1. Create a bot

  2. Publish a workflow

  • Step 1. Debug the workflow you just created.

  • Step 2. Engage in a conversation with your workflow and ensure the conversation is successful.

  • Step 3. You can now click the publish button.

  • Step 4. Select "Publish as API" and click the "Configure" button.

  • Step 5. Select the application you need to bind and bind it. Now you can retrieve the corresponding workflow ID and authentication information. Enjoy!

Note: If you find that you are unable to select an app, you can go to https://www.xfyun.cn to apply.

Manual Installation

To add a persistent client, add the following to your claude_desktop_config.json or mcp.json file:

{
    "mcpServers": {
        "ifly-workflow-mcp-server": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/iflytek/ifly-workflow-mcp-server",
                "ifly_workflow_mcp_server"
            ],
            "env": {
                "CONFIG_PATH": "$CONFIG_PATH"
            }
        }
    }
}

Example config:

{
    "mcpServers": {
        "ifly-workflow-mcp-server": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/iflytek/ifly-workflow-mcp-server",
                "ifly_workflow_mcp_server"
            ],
            "env": {
                "CONFIG_PATH": "/Users/hygao1024/Projects/config.yaml"
            }
        }
    }
}

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.