Dify를 사용하기 위한 간단한 MCP 서버 구현체입니다. MCP의 도구를 호출하여 Dify 워크플로우를 호출합니다.

📰 뉴스

• [2025/4/15] zNow는 환경 변수를 직접 사용하여 base_url와 app_sks를 전달할 수 있어, 클라우드 호스팅 플랫폼에서 더 편리하게 사용할 수 있습니다.

🔨설치

서버는 Smithery를 통해 설치하거나 수동으로 설치할 수 있습니다.

Step1: prepare config.yaml or enviroments

서버 구성은 환경 변수나 config.yaml 파일 중 하나를 사용할 수 있습니다.

방법 1: 환경 변수 사용 (클라우드 플랫폼에 권장)

다음 환경 변수를 설정하세요:

• DIFY_BASE_URL: Dify API의 기본 URL.
• DIFY_APP_SKS: 쉼표로 구분된 Dify 앱 비밀 키(SK) 목록입니다. 각 SK는 일반적으로 MCP를 통해 제공하고자 하는 다른 Dify 워크플로우에 해당합니다.

방법 2: config.yaml 사용

Dify 기본 URL과 앱 SK를 저장할 config.yaml 파일을 만드세요.

예시 config.yaml:

• dify_base_url: Dify API의 기본 URL.
• dify_app_sks: Dify 앱 비밀 키(SK) 목록입니다. 각 SK는 일반적으로 서로 다른 Dify 워크플로우에 대응합니다.

Model Context Protocol (MCP) Server for dify workflows

A simple implementation of an MCP server for using dify. It achieves the invocation of the Dify workflow by calling the tools of MCP.

📰 News

• [2025/4/15] zNow supports directly using environment variables to pass base_url and app_sks, making it more convenient to use with cloud-hosted platforms.

🔨Installation

The server can be installed via Smithery or manually.

Step1: prepare config.yaml or enviroments

You can configure the server using either environment variables or a config.yaml file.

Method 1: Using Environment Variables (Recommended for Cloud Platforms)

Set the following environment variables:

export DIFY_BASE_URL="https://cloud.dify.ai/v1"
export DIFY_APP_SKS="app-sk1,app-sk2" # Comma-separated list of your Dify App SKs

• DIFY_BASE_URL: The base URL for your Dify API.
• DIFY_APP_SKS: A comma-separated list of your Dify App Secret Keys (SKs). Each SK typically corresponds to a different Dify workflow you want to make available via MCP.

Method 2: Using config.yaml

Create a config.yaml file to store your Dify base URL and App SKs.

Example config.yaml:

dify_base_url: "https://cloud.dify.ai/v1"
dify_app_sks:
  - "app-sk1" # SK for workflow 1
  - "app-sk2" # SK for workflow 2
  # Add more SKs as needed

• dify_base_url: The base URL for your Dify API.
• dify_app_sks: A list of your Dify App Secret Keys (SKs). Each SK typically corresponds to a different Dify workflow.

You can create this file quickly using the following command (adjust the path and values as needed):

# Create a directory if it doesn't exist
mkdir -p ~/.config/dify-mcp-server

# Create the config file
cat > ~/.config/dify-mcp-server/config.yaml <<EOF
dify_base_url: "https://cloud.dify.ai/v1"
dify_app_sks:
  - "app-your-sk-1"
  - "app-your-sk-2"
EOF

echo "Configuration file created at ~/.config/dify-mcp-server/config.yaml"

When running the server (as shown in Step 2), you will need to provide the path to this config.yaml file via the CONFIG_PATH environment variable if you choose this method.

Step2: Installation on your client

❓ If you haven’t installed uv or uvx yet, you can do it quickly with the following command:

curl -Ls https://astral.sh/uv/install.sh | sh

✅ Method 1: Use uvx (no need to clone code, recommended)

{
"mcpServers": {
  "dify-mcp-server": {
    "command": "uvx",
      "args": [
        "--from","git+https://github.com/YanxingLiu/dify-mcp-server","dify_mcp_server"
      ],
    "env": {
       "DIFY_BASE_URL": "https://cloud.dify.ai/v1",
       "DIFY_APP_SKS": "app-sk1,app-sk2",
    }
  }
}
}

or

{
"mcpServers": {
  "dify-mcp-server": {
    "command": "uvx",
      "args": [
        "--from","git+https://github.com/YanxingLiu/dify-mcp-server","dify_mcp_server"
      ],
    "env": {