Dify MCP Server

Dify MCP Server

English | 中文

一个基于 TypeScript 的 MCP（Model Context Protocol）服务，用于连接 MCP 客户端与 Dify 应用。此服务会动态将 Dify 应用公开为工具，可直接在 MCP 客户端中使用。

概述

此服务实现了 Model Context Protocol，用于连接 MCP 客户端与 Dify 应用。它会从 Dify API 动态获取应用规格，并将其公开为 MCP 工具。用户可以通过 MCP 客户端中的统一界面与多个 Dify 应用交互。

功能特性

动态集成 Dify

• 使用 API 密钥连接多个 Dify 应用
• 自动获取应用元数据和参数
• 根据 Dify 应用规格动态生成工具界面
• 支持多种输入类型，包括文本、段落和下拉选择框

请求处理

• 通过请求重试实现稳健的错误处理
• 支持阻塞和流式响应模式
• 支持处理大型数值的 JSON BigInt

配置

• 通过环境变量配置 API 密钥
• 可配置基础 URL 和超时设置
• 环境变量不可用时回退到默认值

安装

先决条件

• Node.js（v16 或更高版本）
• npm 或 yarn

设置

1. 克隆仓库

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

2. 安装依赖项

npm install

3. 构建项目

npm run build

与 Windsurf IDE 集成

要与 Windsurf IDE 配合使用，请将服务配置添加到 MCP 设置中：

{
  "mcpServers": {
    "dify-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/dify-mcp-server/build/index.js"
      ],
      "env": {
        "AGENT_API_KEYS": "key1,key2,key3",
        "BASE_URL": "https://api.dify.ai",
        "TIMEOUT": "60000"
      }
    }
  }
}

环境变量

• AGENT_API_KEYS：以逗号分隔的 Dify API 密钥列表
• BASE_URL：Dify API 的基础 URL（默认值：https://api.dify.ai）
• TIMEOUT：请求超时时间，单位为毫秒（默认值：60000）

如何获取环境变量

API 密钥（AGENT_API_KEYS）：多个密钥之间以,分隔

使用方法

配置完成后，Dify MCP Server 将：

1. 使用提供的 API 密钥连接指定的 Dify 应用
2. 获取应用元数据和参数规格
3. 根据 Dify 应用配置生成 MCP 工具界面
4. 在 Windsurf IDE 中提供这些工具

每个 Dify 应用都会作为一个独立工具公开，名称格式为 dify_app_info_{application_name}。

开发

可用脚本

• npm run build：构建项目
• npm run prepare：准备分发项目
• npm run watch：监视更改并重新构建
• npm run inspector：运行 MCP inspector 进行调试

项目结构

• src/index.ts：主服务实现
• src/request.ts：用于与 Dify API 通信的 HTTP 客户端
• src/type.ts：Dify API 的 TypeScript 接口

故障排除

如果遇到问题：

1. 确认 API 密钥正确且具有必要的权限
2. 检查 BASE_URL 是否可从你的环境访问
3. 查看服务日志以获取详细错误信息
4. 确保 Dify 应用已正确配置且可访问

许可证

本项目遵循 LICENSE 文件中指定的条款。