Máy chủ iFly-Spark-Agent-MCP

Máy chủ iFly-Spark-Agent-MCP làm gì?

Máy chủ iFly-Spark-Agent-MCP là một ví dụ triển khai đơn giản kết nối các trợ lý AI với Nền tảng iFlytek SparkAgent bằng Giao thức Ngữ cảnh Mô hình (MCP). Máy chủ này đóng vai trò cầu nối, cho phép các client AI gọi các chuỗi tác vụ trên Nền tảng SparkAgent thông qua một giao diện tiêu chuẩn. Bằng cách cung cấp các công cụ như tải tệp, nó giúp tích hợp AI liền mạch cho các tác vụ như quản lý tệp, tự động hóa quy trình và điều phối workflow. Máy chủ được thiết kế để nâng cao quy trình phát triển bằng cách tạo điều kiện giao tiếp giữa trợ lý AI và các năng lực SparkAgent, giúp nhà phát triển dễ dàng bổ sung các chức năng nâng cao cho ứng dụng của mình.

Danh sách Prompt

Không có mẫu prompt nào được đề cập trong kho lưu trữ.

Danh sách Tài nguyên

Không có tài nguyên nào được liệt kê hoặc mô tả trong kho lưu trữ.

Danh sách Công cụ

• upload_file
  Cho phép client tải tệp lên bằng cách chỉ định đường dẫn tệp. Công cụ này cung cấp khả năng quản lý tệp cho client AI, giúp họ gửi tệp lên Nền tảng SparkAgent để xử lý tiếp hoặc thực thi workflow.

Ứng dụng của máy chủ MCP này

• Tải lên và Quản lý tệp
  Nhà phát triển có thể sử dụng công cụ upload_file để chuyển tệp cục bộ lên Nền tảng SparkAgent, tự động hóa các workflow dựa trên tệp hoặc khởi tạo các pipeline xử lý.
• Kích hoạt chuỗi tác vụ
  Máy chủ cho phép client AI kích hoạt các chuỗi tác vụ trên Nền tảng SparkAgent, giúp đơn giản hóa các thao tác phức tạp cần điều phối nhiều bước hoặc dịch vụ.
• Tích hợp với các công cụ phát triển AI
  Nhờ hỗ trợ MCP, máy chủ có thể tích hợp với các môi trường phát triển AI như Claude, Cursor, và Windsurf, giúp kết nối ứng dụng AI với các năng lực SparkAgent dễ dàng hơn.
• Thực thi workflow tự động
  Nhà phát triển có thể tự động hóa các tác vụ lặp lại hoặc xử lý hàng loạt bằng cách gọi workflow của SparkAgent thông qua giao diện máy chủ MCP.

Cách thiết lập

Windsurf

Không tìm thấy hướng dẫn cụ thể cho Windsurf.

Claude

1. Đảm bảo các điều kiện tiên quyết:
   • Cài đặt Node.js và uv hoặc uvx.
   • Tải về hoặc clone kho lưu trữ iFly-Spark-Agent-MCP.
2. Tìm và mở claude_desktop_config.json hoặc mcp.json.
3. Thêm máy chủ bằng một trong hai phương pháp:

Sử dụng uv:

{
  "mcpServers": {
    "ifly-spark-agent-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ifly-spark-agent-mcp",
        "run",
        "ifly-spark-agent-mcp"
      ],
      "env": {
        "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
        "IFLY_SPARK_AGENT_APP_ID": "xxxx",
        "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
      }
    }
  }
}

Sử dụng uvx với kho GitHub:

{
  "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": "xxxx",
        "IFLY_SPARK_AGENT_APP_ID": "xxxx",
        "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
      }
    }
  }
}

4. Lưu file cấu hình và khởi động lại Claude.
5. Kiểm tra thiết lập bằng cách liệt kê các công cụ có sẵn hoặc thử chạy một lệnh.

Bảo mật API Key

Lưu các key nhạy cảm trong mục env:

"env": {
  "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
  "IFLY_SPARK_AGENT_APP_ID": "xxxx",
  "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
}

Cursor

Không tìm thấy hướng dẫn cụ thể cho Cursor.

Cline

Không tìm thấy hướng dẫn cụ thể cho Cline.

Cách sử dụng MCP này trong các flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt, bắt đầu bằng cách thêm thành phần MCP vào flow của bạn và kết nối với agent AI:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP của hệ thống, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "ifly-spark-agent-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và năng lực của nó. Lưu ý thay “ifly-spark-agent-mcp” cho phù hợp với tên và URL máy chủ thực tế của bạn.

Tổng quan

Dựa trên tài liệu hiện có, máy chủ MCP này chỉ cung cấp các chức năng cơ bản, chủ yếu xoay quanh một công cụ (upload_file). Có hướng dẫn thiết lập đơn giản và thông tin giấy phép rõ ràng, nhưng thiếu các tính năng nâng cao, mẫu prompt và định nghĩa tài nguyên. Phạm vi của nó hạn chế nhưng rõ ràng, phù hợp làm ví dụ hoạt động tối thiểu. Tổng thể, mức độ đa dạng và chiều sâu được đánh giá từ thấp đến trung bình.

Điểm MCP