基本能力
产品定位
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
安装教程
-
克隆仓库
bash
git clone https://github.com/zhuzhoulin/dify-mcp-server.git
cd dify-mcp-server -
安装依赖
bash
npm install -
构建项目
bash
npm run build
集成到 Windsurf IDE
在 MCP 设置中添加服务器配置：
json
{
"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 检查器进行调试
bash
npm run inspector -
查看服务器日志以获取详细错误信息
- 确保环境变量（如
AGENT_API_KEYS、BASE_URL和TIMEOUT）已正确设置。
