AI导哈

Dify API管理服务器

Dify-MCP-Server是一个用于管理Dify控制台API的服务器，支持通过Claude代码或任何MCP客户端程序化地管理应用程序、工作流、知识库、模型、插件和MCP服务器。

  • by overpod
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 overpod/dify-mcp-server

使用说明

dify mcp服务器

MCP服务器 迪菲 控制台API-通过Claude Code或任何MCP客户端以编程方式管理应用程序、工作流、知识库、模型、插件和MCP服务器。

适用于自托管Dify v1.6+实例（建议插件和MCP工具使用v1.10+）。

你能做什么？

  • 从Claude Code创建和配置Dify应用程序
  • 将应用程序导入/导出为YAML DSL模板
  • 使用数据集、文档和片段构建知识库
  • 管理模型提供程序并设置默认模型
  • 安装、升级和删除插件
  • 以编程方式将MCP服务器连接到Dify
  • 使用标签组织应用程序
  • 浏览对话和消息历史记录

快速开始

选项A：自制 （macOS/Linux）：

brew tap overpod/tap
brew install dify-mcp-server

选项B：下载二进制文件 （不需要依赖关系）：

# macOS (Apple Silicon)
curl -L https://github.com/overpod/dify-mcp-server/releases/latest/download/dify-mcp-server-darwin-arm64 -o dify-mcp-server
chmod +x dify-mcp-server

# macOS (Intel)
curl -L https://github.com/overpod/dify-mcp-server/releases/latest/download/dify-mcp-server-darwin-x64 -o dify-mcp-server
chmod +x dify-mcp-server

# Linux (x64)
curl -L https://github.com/overpod/dify-mcp-server/releases/latest/download/dify-mcp-server-linux-x64 -o dify-mcp-server
chmod +x dify-mcp-server

窗户：

Invoke-WebRequest -Uri "https://github.com/overpod/dify-mcp-server/releases/latest/download/dify-mcp-server-windows-x64.exe" -OutFile "dify-mcp-server.exe"

添加到您的 .mcp.json:

{
  "mcpServers": {
    "dify": {
      "command": "./dify-mcp-server",
      "env": {
        "DIFY_BASE_URL": "https://your-dify-instance.com",
        "DIFY_EMAIL": "admin@example.com",
        "DIFY_PASSWORD": "your-password"
      }
    }
  }
}

使用克劳德代码：

“列出我的所有Dify应用程序” “创建一个名为客户支持的新聊天应用程序” “将客户支持应用程序导出为YAML” “在以下位置连接MCP服务器https://mcp.example.com/sse以堤防” “我的Dify实例中配置了哪些模型？”

备选方案：来源

git clone https://github.com/overpod/dify-mcp-server
cd dify-mcp-server
bun install && bun run build
bun dist/index.js

用例示例

从模板创建代理

1. export_app → get YAML DSL of an existing app
2. Edit the YAML (change prompt, model, tools)
3. import_dsl → import as a new app
4. publish_workflow → make it live
5. enable_api + create_api_key → get API access

建立知识库

1. create_dataset → new knowledge base
2. create_document_by_text → add documents
3. Attach dataset to an app workflow

将MCP服务器连接到Dify

1. create_mcp_server → add by URL (auto-discovers tools)
2. list_mcp_servers → verify connection
3. get_mcp_server_tools → see available tools
4. refresh_mcp_server_tools → update after changes

管理模型配置

1. list_model_providers → see configured providers
2. list_models → check available models
3. set_default_model → set workspace default LLM

发展

git clone https://github.com/overpod/dify-mcp-server
cd dify-mcp-server
bun install

# Hot reload
DIFY_BASE_URL=https://your-dify.com DIFY_EMAIL=admin@example.com DIFY_PASSWORD=secret bun run dev

# Type check and lint
bun run check    # biome check
bun run build    # tsc

# Run tests
bun run test

# Test with MCP Inspector
npx @modelcontextprotocol/inspector bun dist/index.js

需求

  • 包子 1.3+
  • 自托管Dify v1.6+实例
  • 确定管理员帐户（电子邮件/密码）

贡献

  1. 分叉repo并创建一个分支 main
  2. 跑 bun run check --代码必须通过生物识别
  3. 跑 bun run build --代码必须编译无错误
  4. 跑 bun run test --测试必须通过
  5. 更新 CHANGELOG.md 在...之下 ## [Unreleased]
  6. 让PR保持专注——每个PR都有一个功能或修复

添加新工具

  1. 将API方法添加到 src/dify-client.ts
  2. 在中注册MCP工具 src/index.ts 使用Zod模式
  3. 向添加条目 CHANGELOG.md

代码风格

  • 格式化器/门楣： 生物群系 （标签，100线宽）
  • 语言： TypeScript严格模式
  • 跑 bun run fix 自动格式化

发布

发布是自动化的。标记并推送：

git tag v0.7.0
git push --tags

GitHub Actions为所有平台构建二进制文件，并创建带有CHANGELOG注释的版本。

验证注释

  • 使用Dify未记录的控制台API(/console/api/)
  • 密码采用Base64编码（Dify @decrypt_password_field)
  • 使用CSRF令牌通过HttpOnly Cookie进行身份验证（Dify 1.9.2+）
  • 首次请求时自动登录，401时自动重试
  • 控制台API是内部的-可能在Dify版本之间发生变化

许可证

麻省理工学院

相关 MCP