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"
            }
        }
    }
}

📚 詳細文檔

文檔未提供詳細說明，暫不展示。

🔧 技術細節

文檔未提供具體的技術實現細節，暫不展示。

📄 許可證

文檔未提及許可證信息，暫不展示。