Ifly Spark Agent MCP

🚀 飞语-SPARK-Agent-MCP

このプロジェクトは、MCPサーバーを使用して飞语SPARK Agentプラットフォームのタスクチェーンを呼び出すシンプルなサンプルです。

🚀 クイックスタート

💻 使用例

基本的な使用法

# 標準入出力でサーバーを起動する（デフォルト）
uv run 飞语-SPARK-Agent-MCP

# カスタムポートでSSE伝送を使用してサーバーを起動する
uv run 飞语-SPARK-Agent-MCP --transport sse --port 8000

デフォルトでは、サーバーにはupload_fileというツールが用意されており、以下の必須パラメータを受け付けます。

• file: アップロードするファイルのパス

高度な使用法

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