Dify MCP Server
2025.04.08
4
JavaScriptMCP 服务器Dify 集成工具接口开发效率
Dify MCP Server 是一个基于 TypeScript 的 MCP（Model Context Protocol）服务器，用于连接 MCP 客户端和 Dify 应用程序。该服务器动态地将 Dify 应用程序暴露为工具，可以直接在 MCP 客户端中使用。通过统一的接口，用户可以在 MCP 客户端中与多个 Dify 应用程序进行交互。
View on GitHub
Overview
基本能力
产品定位
Dify MCP Server 是一个桥梁服务，用于连接 MCP 客户端和 Dify 应用程序，动态地将 Dify 应用程序暴露为工具，供 MCP 客户端直接使用。
核心功能
- 动态 Dify 集成
- 使用 API 密钥连接多个 Dify 应用程序
- 自动获取应用程序元数据和参数
- 基于 Dify 应用程序规范动态生成工具接口
-
支持多种输入类型，包括文本、段落和下拉选择
-
请求处理
- 具有重试机制的健壮错误处理
- 支持阻塞和流式响应模式
-
处理大型数值的 JSON BigInt
-
配置
- 通过环境变量配置 API 密钥
- 可配置的基础 URL 和超时设置
- 环境变量不可用时回退到默认值
适用场景
- 在 MCP 客户端中集成多个 Dify 应用程序
- 动态生成工具接口以简化 Dify 应用程序的使用
- 需要统一接口管理多个 Dify 应用程序的场景
工具列表
- Dify 应用程序工具：动态生成的工具接口，格式为
dify_app_info_{application_name}，用于在 MCP 客户端中直接使用 Dify 应用程序。
常见问题解答
- API 密钥无效：确保 API 密钥正确且具有必要的权限。
- BASE_URL 不可访问：检查 BASE_URL 是否可从您的环境中访问。
- 服务器日志错误：查看服务器日志以获取详细的错误信息。
- Dify 应用程序配置问题：确保 Dify 应用程序已正确配置并可访问。
使用教程
使用依赖
- Node.js (v16 或更高版本)
- npm 或 yarn
安装教程
- 克隆仓库
git clone https://github.com/zhuzhoulin/dify-mcp-server.git
cd dify-mcp-server
- 安装依赖
npm install
- 构建项目
npm run build
集成到 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"
}
}
}
}
调试方式
- 运行 MCP 检查器进行调试
npm run inspector
- 查看服务器日志以获取详细错误信息
- 确保环境变量（如
AGENT_API_KEYS、BASE_URL和TIMEOUT）已正确设置。