ifly-spark-agent-mcp

Name: ifly-spark-agent-mcp
Author: iflytek

@iflytek

Repository

About ifly-spark-agent-mcp

This is a simple example of using MCP Server to invoke the task chain of the iFlytek SparkAgent Platform.

#iflytek #mcp-server #sparkagent

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ifly-spark-agent-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/iflytek/ifly-spark-agent-mcp",
        "ifly-spark-agent-mcp"
      ],
      "env": {
        "IFLY_SPARK_AGENT_BASE_URL": "<YOUR SERVER HOST>",
        "IFLY_SPARK_AGENT_APP_ID": "<YOUR APP ID>",
        "IFLY_SPARK_AGENT_APP_SECRET": "<YOUR APP SECRET>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ifly-spark-agent-mcp?

ifly-spark-agent-mcp is a simple MCP server that invokes task chains on the iFlytek SparkAgent Platform. It exposes a single tool, upload_file, and is intended for developers using MCP clients (like Claude) to interact with SparkAgent workflows.

How to use ifly-spark-agent-mcp?

Start the server locally with uv run ifly-spark-agent-mcp (stdio transport) or pass --transport sse --port 8000 for SSE transport. For persistent use with Claude, add a configuration to claude_desktop_config.json using uv or uvx, setting the required environment variables: IFLY_SPARK_AGENT_BASE_URL, IFLY_SPARK_AGENT_APP_ID, and IFLY_SPARK_AGENT_APP_SECRET.

Key features of ifly-spark-agent-mcp

Exposes a single upload_file tool with a required file argument.
Supports both stdio and SSE transports.
Runs locally with uv or globally with uvx from GitHub.
Designed as a minimal example for MCP + SparkAgent integration.
Easy to configure in MCP-compatible clients like Claude.

Use cases of ifly-spark-agent-mcp

Upload a local file to a SparkAgent task chain from an MCP client.
Prototype MCP integrations with iFlytek’s SparkAgent Platform.
Provide a reusable recipe for building custom SparkAgent MCP servers.

FAQ from ifly-spark-agent-mcp

What does the `upload_file` tool do?

It accepts a file path and sends that file to the SparkAgent platform task chain. The exact behavior depends on the platform’s workflow.

How do I configure the environment variables?

Set IFLY_SPARK_AGENT_BASE_URL, IFLY_SPARK_AGENT_APP_ID, and IFLY_SPARK_AGENT_APP_SECRET in the MCP client’s configuration (e.g., env block in claude_desktop_config.json).