使用说明

项目简介

Dify MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它充当 MCP 客户端和 Dify 应用之间的桥梁。通过此服务器，可以将 Dify 应用的功能以工具的形式集成到任何兼容 MCP 协议的客户端（如 Windsurf IDE）中，实现通过 MCP 客户端调用 Dify 应用的功能。

主要功能点

动态集成 Dify 应用: 通过配置 Dify 应用的 API 密钥，服务器可以自动连接到多个 Dify 应用，并动态获取这些应用的信息和参数配置。
Dify 应用转 MCP 工具: 服务器将 Dify 应用的功能抽象并转换为 MCP 协议定义的工具，使得 MCP 客户端可以像使用本地工具一样调用 Dify 应用的功能。
统一工具接口: 所有集成的 Dify 应用都将以标准化的 MCP 工具形式暴露给客户端，方便用户在一个统一的界面中使用来自不同 Dify 应用的功能。
支持多种输入类型: 支持 Dify 应用定义的多种输入类型，包括文本、段落、下拉选择等，保证了工具调用的灵活性和完整性。

安装步骤

安装 Node.js: 确保你的开发环境中已安装 Node.js (v16 或更高版本) 和 npm 包管理器。

克隆仓库: 使用 Git 克隆 'dify-mcp-server' 仓库到本地：

git clone https://github.com/zhuzhoulin/dify-mcp-server.git
cd dify-mcp-server

安装依赖: 在仓库根目录下，运行 npm 命令安装项目依赖：
```
npm install
```
构建项目: 运行 npm 命令构建项目，生成可执行的服务器代码：
```
npm run build
```

服务器配置

为了让 MCP 客户端（例如 Windsurf IDE）能够连接到 Dify MCP Server，你需要在客户端中配置服务器的启动信息。以下是一个 JSON 格式的配置示例，你需要将其添加到 MCP 客户端的服务器配置中。

{
  "mcpServers": {
    "dify-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/dify-mcp-server/build/index.js" // 请将 "/path/to/dify-mcp-server" 替换为你的本地仓库路径
      ],
      "env": {
        "AGENT_API_KEYS": "YOUR_DIFY_API_KEY1,YOUR_DIFY_API_KEY2", // 填写你的 Dify 应用 API 密钥，多个密钥用逗号分隔
        "BASE_URL": "https://api.dify.ai", // Dify API 的基础 URL，默认为 https://api.dify.ai，通常无需修改
        "TIMEOUT": "60000" // 请求超时时间，单位毫秒，默认为 60000，可根据网络情况调整
      }
    }
  }
}

配置参数说明:

'command': 启动服务器的命令，这里使用 'node' 表示使用 Node.js 运行。
'args': 启动命令的参数，指向编译后的服务器入口文件 '/path/to/dify-mcp-server/build/index.js'，请务必替换为你的实际路径。
'env': 环境变量配置，包含以下键值对：
- 'AGENT_API_KEYS': 必须配置。你的 Dify 应用 API 密钥，用于服务器连接到 Dify API。如果需要连接多个 Dify 应用，请使用逗号分隔多个 API 密钥。
- 'BASE_URL': 可选配置。Dify API 的基础 URL，默认为 'https://api.dify.ai'。在大多数情况下，你无需修改此配置。
- 'TIMEOUT': 可选配置。服务器请求 Dify API 的超时时间，单位为毫秒，默认为 '60000' 毫秒（60 秒）。如果网络环境较差，可以适当增加此值。

基本使用方法

启动 MCP 服务器: 在 MCP 客户端中配置并启动 Dify MCP Server。客户端会根据你提供的配置启动服务器。
查看可用工具: 服务器成功启动后，MCP 客户端通常会自动或手动刷新工具列表。你应该能在工具列表中看到以 'dify_app_info_' 开头的工具，每个工具对应一个你配置 API 密钥的 Dify 应用。工具名称的格式为 'dify_app_info_{application_name}'，其中 '{application_name}' 是 Dify 应用的名称。
调用 Dify 工具: 在 MCP 客户端中，你可以像调用其他 MCP 工具一样调用这些 Dify 工具。工具的输入参数会根据 Dify 应用的配置动态生成，你只需要按照提示填写参数并执行工具，即可调用 Dify 应用的功能。工具的返回结果会以文本形式展示在客户端中。

关键词