Ifly Spark Agent MCP

🚀 飞语-SPARK-Agent-MCP

这是一个借助MCP服务器调用飞语SPARK Agent平台任务链的简单示例，能帮助你快速实现相关功能。

🚀 快速开始

✨ 主要特性

• 支持使用标准输入输出（默认）或SSE传输启动服务器。
• 服务器默认提供upload_file工具，可用于文件上传。
• 可在Claude上添加持久客户端，方便使用。

📦 安装指南

文档未提及具体安装步骤，暂不展示。

💻 使用示例

基础用法

本地调试

使用标准输入输出（默认）或SSE传输启动服务器：

# 使用标准输入输出传输（默认）
uv run 飞语-SPARK-Agent-MCP

# 使用自定义端口的SSE传输
uv run 飞语-SPARK-Agent-MCP --transport sse --port 8000

默认情况下，服务器提供了一个名为upload_file的工具，接受一个必需参数：

• file: 要上传的文件路径

MCP客户端示例

使用MCP客户端时，可以通过以下方式调用工具（使用标准输入输出传输）：

import asyncio
from mcp.client.session import ClientSession
from mcp.client.stdio import StdioServerParameters, stdio_client


async def main():
    async with stdio_client(
        StdioServerParameters(command="uv", args=["run", "飞语-SPARK-Agent-MCP"])
    ) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # 列出可用工具
            tools = await session.list_tools()
            print(tools)

            # 调用upload_file工具
            result = await session.call_tool("upload_file", {"file": "/path/to/file"})
            print(result)


asyncio.run(main())

高级用法

使用MCP客户端

在Claude上使用

要在Claude上添加一个持久客户端，请将以下内容添加到你的claude_desktop_config.json或mcp.json文件中：

1. 使用uv

{
  "mcpServers": {
    "飞语-SPARK-Agent-MCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/飞语-SPARK-Agent-MCP",
        "run",
        "飞语-SPARK-Agent-MCP"
      ],
      "env": {
        "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
        "IFLY_SPARK_AGENT_APP_ID": "xxxx",
        "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
      }
    }
  }
}

2. 使用uvx和GitHub仓库

{
    "mcpServers": {
        "飞语-SPARK-Agent-MCP": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/iflytek/飞语-SPARK-Agent-MCP",
                "飞语-SPARK-Agent-MCP"
            ],
            "env": {
              "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
              "IFLY_SPARK_AGENT_APP_ID": "xxxx",
              "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
            }
        }
    }
}

📚 详细文档

文档未提供详细说明，暂不展示。

🔧 技术细节

文档未提供具体的技术实现细节，暂不展示。

📄 许可证

文档未提及许可证信息，暂不展示。