使用说明

项目简介

Dify MCP Server 是一个 MCP (Model Context Protocol) 服务器，旨在将 Dify 的工作流以标准化的方式暴露给支持 MCP 协议的 LLM 客户端。通过此服务器，LLM 应用可以利用 Dify 强大的工作流能力，例如知识检索、Agent 编排等，作为其上下文信息和功能扩展。

主要功能点

Dify 工作流集成: 将 Dify 中预先配置的工作流转化为 MCP 工具，方便 LLM 客户端调用。
工具发现: 支持 MCP 的工具列表 (listTools) 协议，允许客户端动态发现可用的 Dify 工作流工具。
工具调用: 支持 MCP 的工具调用 (callTool) 协议，允许客户端通过工具名称和参数执行 Dify 工作流。
配置灵活: 通过 YAML 配置文件管理 Dify API 的连接信息和应用密钥。
安装便捷: 提供 Smithery 自动安装和手动安装两种方式。

安装步骤

准备配置文件 'config.yaml': 在安装 Dify MCP Server 之前，您需要创建一个 'config.yaml' 文件，用于配置 Dify API 的基本 URL 和应用密钥。请根据您的 Dify 部署情况填写以下内容，并保存为 'config.yaml' 文件。

dify_base_url: "您的 Dify API 地址，例如 https://cloud.dify.ai/v1"
dify_app_sks:
  - "您的 Dify 应用密钥 1"
  - "您的 Dify 应用密钥 2 (如果有多个工作流，可以配置多个密钥)"

注意: 'dify_app_sks' 中的每个密钥对应一个 Dify 工作流，Dify MCP Server 会将这些工作流作为独立的工具暴露给 MCP 客户端。

选择安装方式:
- 方式一：使用 Smithery 自动安装 (推荐) 如果您使用支持 Smithery 的 MCP 客户端（例如 Claude Desktop），可以使用以下命令自动安装 Dify MCP Server。请确保您已安装 Node.js 和 npm。
```
npx -y @smithery/cli install dify-mcp-server --client claude
```
  按照 Smithery 的提示完成安装。
- 方式二：手动安装 如果您需要手动安装，请按照以下步骤操作： a. 下载或克隆 Dify MCP Server 仓库到本地。 b. 确保您的运行环境中已安装 Python 和必要的依赖库 (仓库中未明确指出，但根据代码推测可能需要 'requests' 和 'omegaconf')。可以使用 'pip install requests omegaconf' 安装。 c. 将您准备好的 'config.yaml' 文件放置在 Dify MCP Server 仓库的根目录下，或者您可以通过环境变量 'CONFIG_PATH' 指定配置文件的路径。 d. 运行 'src/dify_mcp_server/server.py' 文件启动服务器。例如，在仓库根目录下执行 'python -m src.dify_mcp_server.server'。

服务器配置 (MCP 客户端配置)

MCP 客户端需要配置连接到 Dify MCP Server 的信息。以下是一个 MCP 客户端配置示例 (JSON 格式)，您需要将其添加到您的 MCP 客户端的配置文件中。

"mcpServers": {
  "dify-workflows": {  // MCP 服务器名称，客户端内唯一标识即可
    "command": "uv",     // 启动服务器的命令，这里假设使用 uv (或者 python) 运行 Python 代码
    "args": [          // 启动命令的参数
      "--directory", "/path/to/dify-mcp-server",  // Dify MCP Server 仓库的路径，请替换为您的实际路径
      "run", "src.dify_mcp_server.server"         // 运行服务器的入口文件，这里使用模块路径
    ],
    "env": {           // 环境变量
       "CONFIG_PATH": "/path/to/config.yaml"     // config.yaml 文件的路径，请替换为您的实际路径
    }
  }
}

注意:

请将 '/path/to/dify-mcp-server' 替换为您实际的 Dify MCP Server 仓库路径。
请将 '/path/to/config.yaml' 替换为您实际的 'config.yaml' 文件路径。
如果您直接使用 'python' 命令运行服务器，请将 '"command": "uv"' 替换为 '"command": "python"'，并相应调整 'args' 参数。

基本使用方法

确保 Dify MCP Server 已经成功安装并运行。
在您的 MCP 客户端中配置好上述服务器连接信息。
客户端连接到 Dify MCP Server 后，即可通过 MCP 协议发现和调用 Dify 工作流工具。
具体的工具名称和参数将根据您在 Dify 中配置的工作流而定。您可以使用 MCP 客户端的工具列表功能查看可用的 Dify 工作流工具及其参数。

关键词