使用说明

项目简介

本项目是基于 Dify 开源平台构建的 DSL 工作流脚本合集,旨在分享和扩展 Dify 的功能。除了提供可以直接导入 Dify 使用的 DSL 工作流外,本项目还包含基于 'fastapi-mcp' 实现的 MCP 服务器示例,可以将特定功能(如即梦 AI 文生视频)以 MCP 工具的形式提供给支持 MCP 协议的客户端使用。

主要功能点

  • Dify DSL 工作流: 提供开箱即用的 Dify 工作流 DSL 配置文件,涵盖绘画机器人、发票提取、新闻抓取、语音播报、AI 智能体、表格处理、知识库检索等多种应用场景。
  • MCP 服务器示例: 包含基于 FastAPI 和 'fastapi-mcp' 库实现的 MCP 服务器代码示例,例如 'jimeng_video_service.py' 提供了调用即梦 AI 生成视频的 MCP 服务。
  • 工具扩展: 通过 MCP 服务器,可以将仓库中集成的各种 AI 功能(如文生图、文生视频、文本转语音、股票分析、HTML 生成等)以标准化的 MCP 工具形式暴露出来,供 MCP 客户端调用。
  • 学习和自定义: 提供丰富的 DSL 工作流示例和 MCP 服务器代码,方便用户学习 Dify 和 MCP 的使用,并进行二次开发和定制。

安装步骤

  1. Dify DSL 工作流: 本项目主要提供 Dify 的 DSL 配置文件,无需额外安装步骤。用户可以直接下载仓库中的 '.yml' 文件,然后在 Dify 平台中导入这些 DSL 文件即可使用。具体导入方法请参考 README.md 中的“使用说明”部分。
  2. MCP 服务器: 本项目提供了 MCP 服务器的代码示例,例如 'mcp/fastapi-mcp-server/jimeng/jimeng_video_service.py'。要运行这些 MCP 服务器,您需要:
    • 确保已安装 Python 环境。
    • 安装依赖库:根据每个 MCP 服务器示例代码的依赖,使用 'pip install -r requirements.txt' 或手动安装所需的库(例如 'fastapi', 'uvicorn', 'fastapi-mcp', 'requests' 等)。
    • 配置 'config.ini' 文件:在 MCP 服务器代码所在的目录下,通常会有一个 'config.ini' 文件,您需要根据实际情况配置 API 密钥、腾讯云 COS 存储信息、以及其他必要的参数。

服务器配置

对于集成了 'fastapi-mcp' 的 MCP 服务器示例(如 'jimeng_video_service.py'),以下是一个典型的 MCP 客户端配置信息,用于连接和使用该 MCP 服务器提供的工具:

{
  "server name": "Jimeng Video MCP Server",  // MCP 服务器的名称,可自定义
  "command": "python",  // 启动 MCP 服务器的命令,这里假设使用 python 解释器
  "args": ["mcp/fastapi-mcp-server/jimeng/jimeng_video_service.py"],  // 启动命令的参数,指向 MCP 服务器的 Python 脚本路径
  "baseURL": "http://localhost:8088" // MCP 服务器的基础 URL,与服务器代码中 'base_url' 参数一致,请根据实际部署情况修改
}

参数注释:

  • 'server name': 为 MCP 服务器指定一个易于识别的名称。
  • 'command': 运行 MCP 服务器程序的可执行命令。通常是 Python 解释器 'python' 或 'python3'。
  • 'args': 传递给 'command' 的参数列表。对于 Python 服务器,通常是服务器脚本的路径。请根据 MCP 服务器脚本的实际位置进行调整。
  • 'baseURL': MCP 服务器监听的根 URL。请确保与 MCP 服务器代码中配置的 'base_url' 一致。例如,'jimeng_video_service.py' 默认配置为 'http://localhost:8088'。

注意: MCP 服务器的具体启动命令和参数可能会因不同的服务器示例而有所不同。请务必参考每个 MCP 服务器示例代码的说明和配置,并根据实际部署环境进行调整。您可能还需要配置 API 密钥、授权 Token 等信息,这些通常在服务器代码的 'config.ini' 文件中进行配置。

基本使用方法

  1. 部署 MCP 服务器: 如果您需要使用 MCP 服务器提供的工具,请先根据“服务器配置”部分的说明,部署并启动相应的 MCP 服务器示例(如 'jimeng_video_service.py')。
  2. 配置 MCP 客户端: 在支持 MCP 协议的客户端(例如 Dify 或其他 MCP 客户端)中,添加上述“服务器配置”中生成的 JSON 配置信息,以连接到您部署的 MCP 服务器。
  3. 使用 MCP 工具: 连接成功后,您就可以在 MCP 客户端中使用 MCP 服务器提供的工具了。例如,对于 'jimeng_video_service.py' 提供的 MCP 服务器,您可以使用 'generate_video_mcp' 工具来生成 AI 视频。具体的工具调用方法请参考 MCP 客户端的文档。
  4. 导入和使用 DSL 工作流: 如果您只需要使用 DSL 工作流,请直接将仓库中的 '.yml' 文件导入 Dify 平台,并按照 Dify 的使用方法操作即可。

信息

分类

AI与计算