Dify Workflows

Servidor Model Context Protocol (MCP) para fluxos de trabalho do Dify

Uma implementação simples de um servidor MCP para usar dify. Ele realiza a invocação do fluxo de trabalho do Dify chamando as ferramentas do MCP.

📰 Novidades

• [2025/4/15] Agora suporta o uso direto de variáveis de ambiente para passar base_url e app_sks, tornando mais conveniente o uso com plataformas hospedadas em nuvem.

🔨Instalação

O servidor pode ser instalado via Smithery ou manualmente.

Passo 1: prepare o config.yaml ou as variáveis de ambiente

Você pode configurar o servidor usando variáveis de ambiente ou um arquivo config.yaml.

Método 1: Usando Variáveis de Ambiente (Recomendado para Plataformas em Nuvem)

Defina as seguintes variáveis de ambiente:

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: A URL base para sua API do Dify.
• DIFY_APP_SKS: Uma lista separada por vírgulas das suas Chaves Secretas (SKs) do App Dify. Cada SK normalmente corresponde a um fluxo de trabalho diferente do Dify que você deseja disponibilizar via MCP.

Método 2: Usando config.yaml

Crie um arquivo config.yaml para armazenar sua URL base do Dify e as SKs do App.

Exemplo de 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: A URL base para sua API do Dify.
• dify_app_sks: Uma lista das suas Chaves Secretas (SKs) do App Dify. Cada SK normalmente corresponde a um fluxo de trabalho diferente do Dify.

Você pode criar este arquivo rapidamente usando o seguinte comando (ajuste o caminho e os valores conforme necessário):

# 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"

Ao executar o servidor (como mostrado no Passo 2), você precisará fornecer o caminho para este arquivo config.yaml através da variável de ambiente CONFIG_PATH se escolher este método.

Passo 2: Instalação no seu cliente

❓ Se você ainda não instalou o uv ou uvx, pode fazê-lo rapidamente com o seguinte comando:

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

✅ Método 1: Use uvx (não é necessário clonar o código, recomendado)

{
"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",
    }
  }
}
}

ou

{
"mcpServers": {
  "dify-mcp-server": {
    "command": "uvx",
      "args": [
        "--from","git+https://github.com/YanxingLiu/dify-mcp-server","dify_mcp_server"
      ],
    "env": {
       "CONFIG_PATH": "/Users/lyx/Downloads/config.yaml"
    }
  }
}
}

✅ Método 2: Use uv (clone local + início com uv)

Você também pode executar o servidor mcp do dify manualmente nos seus clientes. A configuração do cliente deve ter o seguinte formato:

{
"mcpServers": {
  "mcp-server-rag-web-browser": {
    "command": "uv",
      "args": [
        "--directory", "${DIFY_MCP_SERVER_PATH}",
        "run", "dify_mcp_server"
      ],
    "env": {
       "CONFIG_PATH": "$CONFIG_PATH"
    }
  }
}
}

ou

{
"mcpServers": {
  "mcp-server-rag-web-browser": {
    "command": "uv",
      "args": [
        "--directory", "${DIFY_MCP_SERVER_PATH}",
        "run", "dify_mcp_server"
      ],
    "env": {
       "CONFIG_PATH": "$CONFIG_PATH"
    }
  }
}
}

Exemplo de configuração:

{
"mcpServers": {
  "dify-mcp-server": {
    "command": "uv",
      "args": [
        "--directory", "/Users/lyx/Downloads/dify-mcp-server",
        "run", "dify_mcp_server"
      ],
    "env": {
       "DIFY_BASE_URL": "https://cloud.dify.ai/v1",
       "DIFY_APP_SKS": "app-sk1,app-sk2",
    }
  }
}
}

Aproveite

Por fim, você pode usar as ferramentas do Dify em qualquer cliente que suporte mcp.