Dify MCP 服务器

English | 中文

一个基于 TypeScript 的 MCP (模型上下文协议) 服务器，用于连接 MCP 客户端到 Dify 应用程序。此服务器动态地将 Dify 应用程序公开为可以直接在 MCP 客户端中使用的工具。

概述

此服务器实现了模型上下文协议，以桥接 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 服务器将：

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 检查器进行调试

项目结构

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

故障排除

如果您遇到问题：

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

许可证

本项目根据 LICENSE 文件中指定的条款获得许可。