Dify Connect MCP: Integração perfeita de MCP (Model Context Protocol) para fluxos de trabalho da Dify

🚀 Convite para experimentar: o primeiro software de programação inteligente AI IDE da China Download da versão chinesa do TraeO DeepSeek-R1 e o Doubao-pro estão disponíveis em uma base ilimitada!

Introdução geral

Dify Conectar MCP é um projeto de código aberto hospedado no GitHub que tem como objetivo fornecer aos usuários da plataforma Dify uma ferramenta conveniente para se conectar perfeitamente aos fluxos de trabalho da Dify por meio do protocolo de contexto de modelo (MCP). Desenvolvido pela equipe da difybase, o projeto se concentra em melhorar a eficiência do desenvolvimento de aplicativos de IA e é particularmente adequado para desenvolvedores que precisam integrar fluxos de trabalho complexos. Ele faz a interface eficiente de serviços externos com as funções principais da Dify (por exemplo, invocação de modelos, acesso à base de conhecimento etc.) por meio do suporte a protocolos padronizados. Tanto os desenvolvedores individuais quanto os usuários corporativos podem implementar rapidamente extensões de funcionalidade personalizadas e simplificar o processo de desenvolvimento por meio dessa ferramenta. Atualmente, o projeto ainda está em fase de desenvolvimento, a comunidade é altamente ativa e os desenvolvedores são bem-vindos para contribuir com código ou sugestões.

Lista de funções

Configuração do servidor com suporte ao protocolo MCPEstrutura de servidor: fornece uma estrutura de servidor para conectar fluxos de trabalho da Dify com base no protocolo de contexto de modelo.
Integração da API da DifyPermite a comunicação direta com a plataforma Dify, configurando a chave de API e o URL de base da Dify.
Suporte a vários fluxos de trabalhoPermite que vários fluxos de trabalho da Dify sejam gerenciados e invocados com chaves diferentes.
Fornecimento de contexto padronizadoUtilize o protocolo MCP para garantir uma interação de dados sem problemas entre os serviços externos e a Dify.
Colaboração de código abertoO código do projeto é totalmente de código aberto, os usuários são livres para modificar ou estender a função para atender a necessidades específicas.
Suporte à depuraçãoCompatibilidade com ferramentas como o MCP Inspector para que os desenvolvedores possam depurar e otimizar.

Usando a Ajuda

Processo de instalação

O Dify Connect MCP é um projeto de código aberto baseado no GitHub, que requer alguma base técnica para ser instalado e usado. Aqui estão as etapas detalhadas de instalação:

Preparação ambiental
- Certifique-se de ter o Node.js (versão recomendada 16 ou superior) e o Git instalados em seu computador.
- Se você precisar depurar, é recomendável instalar o MCP Inspector. Você pode obter o método de instalação por meio da documentação oficial.
- Prepare uma conta Dify e obtenha a chave de API (Dify API Key) e o URL de base (geralmente o https://cloud.dify.ai/v1(que pode variar dependendo de sua implantação).
Clonagem do código do projeto
Abra um terminal e digite o seguinte comando para clonar o projeto localmente:

git clone https://github.com/difybase/dify-connect-mcp.git

Quando a clonagem estiver concluída, vá para o diretório do projeto:

cd dify-connect-mcp

Instalação de dependências
O projeto é baseado no desenvolvimento do TypeScript, portanto, você precisa instalar as dependências relevantes. Execute o seguinte comando:

npm install

Isso fará o download automático de todos os pacotes npm necessários para o projeto.

Configuração de variáveis de ambiente
No diretório raiz do projeto, crie um arquivo config.yaml usado para armazenar as informações de configuração da Dify. Um exemplo de configuração é mostrado abaixo:

dify_base_url: "https://cloud.dify.ai/v1"
dify_app_sks.
- "app-sk1"
- "app-sk2"

dify_base_urlEndereço da API para a plataforma Dify.
dify_app_sksChave de fluxo de trabalho: uma lista de chaves para o aplicativo Dify, cada uma correspondendo a um fluxo de trabalho.

Criar e executar
Depois de concluir a configuração, crie o projeto usando o seguinte comando:
```
npm run build
```
Quando a compilação estiver concluída, execute o servidor:
```
npm start
```
Se você vir um registro como "Server running" (Servidor em execução), o servidor foi iniciado com êxito.

Como usar

Depois de instalado, o Dify Connect MCP é executado como um servidor MCP e pode se comunicar com os clientes por meio de entrada e saída padrão (stdio). Abaixo estão os detalhes de como usá-lo:

Configuração do cliente

Para criar um aplicativo no lado do cliente (por exemplo, o Claude Desktop ou outras ferramentas habilitadas para MCP, você precisa adicionar informações do servidor MCP ao arquivo de configuração do cliente. Um exemplo de configuração é mostrado abaixo:

{
"mcpServers": {
"dify-connect-mcp": {
"comando": "node",
"args": ["/build/index.js"],
"env": {
"DIFY_API_KEY": "your-api-key"
}
}
}
}

<你的项目路径>Substituir por dify-connect-mcp O caminho real do
DIFY_API_KEYSubstitua pela chave de API que você obteve da plataforma Dify.

Depois de salvar o arquivo de configuração e reiniciar o cliente, o servidor MCP estabelecerá automaticamente uma conexão com a plataforma Dify.

Invocação de fluxos de trabalho da Dify

Supondo que você tenha criado um fluxo de trabalho na plataforma Dify (por exemplo, um fluxo de trabalho de análise de texto chamado "text-analyzer"), você pode invocá-lo seguindo estas etapas:

seguro config.yaml A chave para o fluxo de trabalho correspondente foi adicionada no

Em um cliente habilitado para MCP, digite um comando semelhante ao seguinte:

Execute o fluxo de trabalho do analisador de texto e insira o texto "Esta é uma mensagem de teste".

O servidor MCP envia a solicitação para a Dify, executa o fluxo de trabalho e retorna os resultados.

Depuração e otimização

Se você encontrar problemas, poderá usar o MCP Inspector para depuração:

Inicie o MCP Inspector (consulte a documentação para obter detalhes).
Execute o seguinte comando no terminal para ativar o modo de depuração:
```
npm run start:debug
```
O Inspector exibe os registros de comunicação para ajudá-lo a localizar problemas.

Funções principais

1. integração da API da Dify

procedimento:: Editorial config.yamlSe você quiser usar a Dify, preencha o URL básico e a chave de API da Dify.
papel funcionalPermite a conectividade com a nuvem da Dify ou com instâncias auto-hospedadas, suportando chamadas para modelos, bases de conhecimento e outros recursos.
advertênciaChave de autenticação: certifique-se de que a chave seja válida e corresponda ao fluxo de trabalho de destino; caso contrário, será retornado um erro de autenticação.

2. gerenciamento de vários fluxos de trabalho

procedimento: em dify_app_sks Várias chaves são adicionadas à lista, cada uma correspondendo a um fluxo de trabalho.
papel funcionalPermite a execução simultânea de vários fluxos de trabalho independentes, como geração de texto, análise de dados, etc.
exemplo de usoConfigure duas teclas para chamar o "Fluxo de trabalho de tradução" e o "Fluxo de trabalho de resumo", respectivamente, e insira o mesmo texto para obter os resultados da tradução e do resumo ao mesmo tempo.

3. extensões personalizadas

procedimento::
1. Modificar o código-fonte do projeto (por exemplo src/index.ts), adicionando novos recursos.
2. Reconstrua e execute:npm run build && npm start.
papel funcionalPara atender a necessidades específicas, como adicionar registro ou lógica de processamento de dados personalizada.
advertênciaRecomenda-se bifurcar o projeto primeiro e testá-lo localmente para evitar modificar diretamente a ramificação principal.

advertência

segurançaNão divulgue a chave da API para outras pessoas; é recomendável que o usuário config.yaml tornar-se um membro .gitignore.
compatibilidadeVerifique se o cliente é compatível com o protocolo MCP, caso contrário, ele não poderá se comunicar.
Suporte à comunidadeSe você tiver problemas, envie comentários na página de problemas do GitHub e os desenvolvedores da comunidade ajudarão.

Com as etapas acima, você pode começar a usar rapidamente o Dify Connect MCP, integrar os fluxos de trabalho da Dify em seus próprios projetos e desfrutar de uma experiência de desenvolvimento de IA eficiente!