使用说明

项目简介

Dify MCP 服务器插件旨在将您的 Dify 聊天应用 (Chatflow) 和工作流应用 (Workflow) 暴露为标准的 Model Context Protocol (MCP) 服务器。通过此插件，您可以轻松地将 Dify 应用的功能集成到任何支持 MCP 协议的客户端，例如 Claude Desktop。

主要功能点

MCP 协议兼容: 完全实现了 Model Context Protocol 规范，确保与 MCP 客户端的无缝对接。
支持多种应用类型: 支持 Dify 的聊天应用 (Chatflow) 和工作流应用 (Workflow)，您可以根据需求选择暴露的应用类型。
多种传输方式: 支持 HTTP JSON-RPC 和 SSE (Server-Sent Events) 两种传输协议，满足不同客户端的需求。
易于配置和使用: 作为 Dify 插件安装，配置简单，无需复杂的部署步骤。
工具集成: 将 Dify 应用的功能封装为 MCP 工具，方便客户端调用。

安装步骤

安装 Dify: 确保您已经安装并运行了 Dify 应用。
安装插件: 将 'difyapp_as_mcp_server' 仓库作为 Dify 插件添加到您的 Dify 实例中。具体的插件安装步骤请参考 Dify 官方文档。
配置插件: 在 Dify 插件配置页面，配置以下参数：
- 应用 (App): 选择您希望作为 MCP 服务器暴露的 Dify 应用。
- 应用类型 (App Type): 选择应用类型，可以是“聊天应用 (Chatflow)” 或 “工作流应用 (Workflow)”。
- 服务器名称 (Server Name): (可选) MCP 服务器的自定义名称。
- 服务器描述 (Server Description): (可选) MCP 服务器的自定义描述。
- API 密钥 (API Key): (可选) Dify 应用的 API 密钥，如果您的 Dify 应用需要 API 密钥验证，请配置此项。

服务器配置

对于 MCP 客户端，您需要配置 MCP 服务器的连接信息。以下是 JSON 格式的配置示例，您需要根据您选择的传输协议 (JSON-RPC 或 SSE) 以及 Dify 实例的 URL 进行配置。

JSON-RPC 配置示例:

{
  "serverName": "Dify MCP Server (JSON-RPC)",
  "command": "https://your-dify-instance.com/api/plugin-endpoint/difyapp_as_mcp_server/mcp-jsonrpc",
  "args": [],
  "description": "Dify 应用 MCP 服务器 (JSON-RPC)",
  "protocol": "mcp",
  "transport": "json-rpc"
}

SSE 配置示例:

{
  "serverName": "Dify MCP Server (SSE)",
  "command": "https://your-dify-instance.com/api/plugin-endpoint/difyapp_as_mcp_server/mcp-sse",
  "args": [],
  "description": "Dify 应用 MCP 服务器 (SSE)",
  "protocol": "mcp",
  "transport": "sse"
}

参数说明:

'serverName': MCP 服务器的名称，用于在客户端中标识。
'command': MCP 服务器的端点 URL。请将 'https://your-dify-instance.com' 替换为您的 Dify 实例的实际 URL。根据您选择的传输协议，选择 '/mcp-jsonrpc' (JSON-RPC) 或 '/mcp-sse' (SSE) 端点。
'args': 启动命令的参数，本插件无需额外参数，留空即可。
'description': MCP 服务器的描述信息。
'protocol': 必须设置为 '"mcp"'，表示 MCP 协议。
'transport': 传输协议，根据您选择的端点，设置为 '"json-rpc"' 或 '"sse"'。

基本使用方法

在 MCP 客户端中添加服务器: 根据您使用的 MCP 客户端（如 Claude Desktop）的指引，添加新的 MCP 服务器，并填入上述配置信息。
连接服务器: 在客户端中启用并连接到您配置的 Dify MCP 服务器。
使用工具: 客户端会通过 MCP 协议与 Dify MCP 服务器通信。
- 客户端可以使用 'list_tools' 方法获取可用的工具列表。
- 对于聊天应用，可以使用 'dify_chat' 工具，通过 'messages' 参数发送消息，'inputs' 参数传递额外的输入。
- 对于工作流应用，可以使用 'dify_workflow' 工具，通过 'inputs' 参数传递工作流所需的输入。
- 具体工具的使用方法和参数，请参考 MCP 客户端的文档或通过 'list_tools' 获取的工具 schema 信息。

关键词