Dumpling AI MCP Server

Ferramentas de raspagem, conversão e extração de dados da Dumpling AI.

Documentação

Servidor MCP Dumpling AI

Uma implementação de servidor Model Context Protocol (MCP) que integra-se ao Dumpling AI para raspagem de dados, processamento de conteúdo, gestão de conhecimento, agentes de IA e capacidades de execução de código.

smithery badge

Recursos

  • Integração completa com todos os endpoints da API Dumpling AI
  • APIs de dados para transcrições do YouTube, busca, autocomplete, mapas, lugares, notícias e avaliações
  • Raspagem web com suporte para scraping, crawling, capturas de tela e extração de dados estruturados
  • Ferramentas de conversão de documentos para extração de texto, operações com PDF, processamento de vídeo
  • Extraia dados de documentos, imagens, áudio e vídeo
  • Capacidades de IA incluindo conclusões de agentes, gestão de base de conhecimento e geração de imagens
  • Ferramentas de desenvolvedor para executar código JavaScript e Python em um ambiente seguro
  • Tratamento automático de erros e formatação detalhada de respostas

Instalação

Instalando via Smithery

Para instalar o mcp-server-dumplingai para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @Dumpling-AI/mcp-server-dumplingai --client claude

Executando com npx

env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai

Instalação Manual

npm install -g mcp-server-dumplingai

Executando no Cursor

Configurando o Cursor 🖥️ Nota: Requer versão 0.45.6+ do Cursor

Para configurar o Dumpling AI MCP no Cursor:

  1. Abra as Configurações do Cursor
  2. Vá para Recursos > Servidores MCP
  3. Clique em "+ Adicionar Novo Servidor MCP"
  4. Insira o seguinte:
{
  "mcpServers": {
    "dumplingai": {
      "command": "npx",
      "args": ["-y", "mcp-server-dumplingai"],
      "env": {
        "DUMPLING_API_KEY": "<your-api-key>"
      }
    }
  }
}

Se você estiver usando Windows e estiver enfrentando problemas, tente cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"

Substitua your-api-key pela sua chave de API do Dumpling AI.

Configuração

Variáveis de Ambiente

  • DUMPLING_API_KEY: Sua chave de API do Dumpling AI (obrigatória)

Ferramentas Disponíveis

APIs de Dados

1. Obter Transcrição do YouTube (get-youtube-transcript)

Extraia transcrições de vídeos do YouTube com carimbos de data/hora opcionais.

{
  "name": "get-youtube-transcript",
  "arguments": {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "includeTimestamps": true,
    "timestampsToCombine": 3,
    "preferredLanguage": "en"
  }
}

2. Busca (search)

Realize buscas na web do Google e opcionalmente raspe conteúdo dos resultados.

{
  "name": "search",
  "arguments": {
    "query": "machine learning basics",
    "country": "us",
    "language": "en",
    "dateRange": "pastMonth",
    "scrapeResults": true,
    "numResultsToScrape": 3,
    "scrapeOptions": {
      "format": "markdown",
      "cleaned": true
    }
  }
}

3. Obter Autocomplete (get-autocomplete)

Obtenha sugestões de autocomplete da busca do Google para uma consulta.

{
  "name": "get-autocomplete",
  "arguments": {
    "query": "how to learn",
    "country": "us",
    "language": "en",
    "location": "New York"
  }
}

4. Buscar Mapas (search-maps)

Busque no Google Maps por locais e empresas.

{
  "name": "search-maps",
  "arguments": {
    "query": "coffee shops",
    "gpsPositionZoom": "37.7749,-122.4194,14z",
    "language": "en",
    "page": 1
  }
}

5. Buscar Lugares (search-places)

Busque por lugares com informações mais detalhadas.

{
  "name": "search-places",
  "arguments": {
    "query": "hotels in paris",
    "country": "fr",
    "language": "en",
    "page": 1
  }
}

6. Buscar Notícias (search-news)

Busque artigos de notícias com parâmetros personalizáveis.

{
  "name": "search-news",
  "arguments": {
    "query": "climate change",
    "country": "us",
    "language": "en",
    "dateRange": "pastWeek"
  }
}

7. Obter Avaliações do Google (get-google-reviews)

Recupere avaliações do Google para empresas ou lugares.

{
  "name": "get-google-reviews",
  "arguments": {
    "businessName": "Eiffel Tower",
    "location": "Paris, France",
    "limit": 10,
    "sortBy": "relevance"
  }
}

Raspagem Web

8. Raspar (scrape)

Extraia conteúdo de uma página web com opções de formatação.

{
  "name": "scrape",
  "arguments": {
    "url": "https://example.com",
    "format": "markdown",
    "cleaned": true,
    "renderJs": true
  }
}

9. Rastrear (crawl)

Rastreie sites recursivamente e extraia conteúdo com parâmetros personalizáveis.

{
  "name": "crawl",
  "arguments": {
    "baseUrl": "https://example.com",
    "maxPages": 10,
    "crawlBeyondBaseUrl": false,
    "depth": 2,
    "scrapeOptions": {
      "format": "markdown",
      "cleaned": true,
      "renderJs": true
    }
  }
}

10. Captura de Tela (screenshot)

Capture capturas de tela de páginas web com opções personalizáveis de viewport e formato.

{
  "name": "screenshot",
  "arguments": {
    "url": "https://example.com",
    "width": 1280,
    "height": 800,
    "fullPage": true,
    "format": "png",
    "waitFor": 1000
  }
}

11. Extrair (extract)

Extraia dados estruturados de páginas web usando instruções alimentadas por IA.

{
  "name": "extract",
  "arguments": {
    "url": "https://example.com/products",
    "instructions": "Extract all product names, prices, and descriptions from this page",
    "schema": {
      "products": [
        {
          "name": "string",
          "price": "number",
          "description": "string"
        }
      ]
    },
    "renderJs": true
  }
}

Conversão de Documentos

12. Documento para Texto (doc-to-text)

Converta documentos para texto simples com OCR opcional.

{
  "name": "doc-to-text",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "options": {
      "ocr": true,
      "language": "en"
    }
  }
}

13. Converter para PDF (convert-to-pdf)

Converta vários formatos de arquivo para PDF.

{
  "name": "convert-to-pdf",
  "arguments": {
    "url": "https://example.com/document.docx",
    "format": "docx",
    "options": {
      "quality": 90,
      "pageSize": "A4",
      "margin": 10
    }
  }
}

14. Mesclar PDFs (merge-pdfs)

Combine múltiplos PDFs em um único documento.

{
  "name": "merge-pdfs",
  "arguments": {
    "urls": ["https://example.com/doc1.pdf", "https://example.com/doc2.pdf"],
    "options": {
      "addPageNumbers": true,
      "addTableOfContents": true
    }
  }
}

15. Cortar Vídeo (trim-video)

Extraia um clipe específico de um vídeo.

{
  "name": "trim-video",
  "arguments": {
    "url": "https://example.com/video.mp4",
    "startTime": 30,
    "endTime": 60,
    "output": "mp4",
    "options": {
      "quality": 720,
      "fps": 30
    }
  }
}

16. Extrair Documento (extract-document)

Extraia conteúdo específico de documentos em vários formatos.

{
  "name": "extract-document",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "format": "structured",
    "options": {
      "ocr": true,
      "language": "en",
      "includeMetadata": true
    }
  }
}

17. Extrair Imagem (extract-image)

Extraia texto e informações de imagens.

{
  "name": "extract-image",
  "arguments": {
    "url": "https://example.com/image.jpg",
    "extractionType": "text",
    "options": {
      "language": "en",
      "detectOrientation": true
    }
  }
}

18. Extrair Áudio (extract-audio)

Transcreva e extraia informações de arquivos de áudio.

{
  "name": "extract-audio",
  "arguments": {
    "url": "https://example.com/audio.mp3",
    "language": "en",
    "options": {
      "model": "enhanced",
      "speakerDiarization": true,
      "wordTimestamps": true
    }
  }
}

19. Extrair Vídeo (extract-video)

Extraia conteúdo de vídeos incluindo transcrições, cenas e objetos.

{
  "name": "extract-video",
  "arguments": {
    "url": "https://example.com/video.mp4",
    "extractionType": "transcript",
    "options": {
      "language": "en",
      "speakerDiarization": true
    }
  }
}

20. Ler Metadados do PDF (read-pdf-metadata)

Extraia metadados de arquivos PDF.

{
  "name": "read-pdf-metadata",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "includeExtended": true
  }
}

21. Escrever Metadados do PDF (write-pdf-metadata)

Atualize metadados em arquivos PDF.

{
  "name": "write-pdf-metadata",
  "arguments": {
    "url": "https://example.com/document.pdf",
    "metadata": {
      "title": "New Title",
      "author": "John Doe",
      "keywords": ["keyword1", "keyword2"]
    }
  }
}

IA

22. Gerar Conclusão de Agente (generate-agent-completion)

Obtenha conclusões de agentes de IA com definições de ferramentas opcionais.

{
  "name": "generate-agent-completion",
  "arguments": {
    "prompt": "How can I improve my website's SEO?",
    "model": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 500,
    "context": ["The website is an e-commerce store selling handmade crafts."]
  }
}

23. Buscar na Base de Conhecimento (search-knowledge-base)

Busque em uma base de conhecimento por informações relevantes.

{
  "name": "search-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "query": "How to optimize database performance",
    "limit": 5,
    "similarityThreshold": 0.7
  }
}

24. Adicionar à Base de Conhecimento (add-to-knowledge-base)

Adicione entradas a uma base de conhecimento.

{
  "name": "add-to-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "entries": [
      {
        "text": "MongoDB is a document-based NoSQL database.",
        "metadata": {
          "source": "MongoDB documentation",
          "category": "databases"
        }
      }
    ],
    "upsert": true
  }
}

25. Gerar Imagem com IA (generate-ai-image)

Gere imagens usando modelos de IA.

{
  "name": "generate-ai-image",
  "arguments": {
    "prompt": "A futuristic city with flying cars and neon lights",
    "width": 1024,
    "height": 1024,
    "numImages": 1,
    "quality": "hd",
    "style": "photorealistic"
  }
}

26. Gerar Imagem (generate-image)

Gere imagens usando vários provedores de IA.

{
  "name": "generate-image",
  "arguments": {
    "prompt": "A golden retriever in a meadow of wildflowers",
    "provider": "dalle",
    "width": 1024,
    "height": 1024,
    "numImages": 1
  }
}

Ferramentas de Desenvolvedor

27. Executar Código JavaScript (run-js-code)

Execute código JavaScript com dependências opcionais.

{
  "name": "run-js-code",
  "arguments": {
    "code": "const result = [1, 2, 3, 4].reduce((sum, num) => sum + num, 0); console.log(`Sum: ${result}`); return result;",
    "dependencies": {
      "lodash": "^4.17.21"
    },
    "timeout": 5000
  }
}

28. Executar Código Python (run-python-code)

Execute código Python com dependências opcionais.

{
  "name": "run-python-code",
  "arguments": {
    "code": "import numpy as np\narr = np.array([1, 2, 3, 4, 5])\nmean = np.mean(arr)\nprint(f'Mean: {mean}')\nreturn mean",
    "dependencies": ["numpy", "pandas"],
    "timeout": 10000,
    "saveOutputFiles": true
  }
}

Tratamento de Erros

O servidor fornece tratamento robusto de erros:

  • Mensagens de erro detalhadas com códigos de status HTTP
  • Validação de chave de API
  • Validação de entrada usando esquemas Zod
  • Tratamento de erros de rede com mensagens descritivas

Exemplo de resposta de erro:

{
  "content": [
    {
      "type": "text",
      "text": "Error: Failed to fetch YouTube transcript: 404 Not Found"
    }
  ],
  "isError": true
}

Desenvolvimento

# Install dependencies
npm install

# Build
npm run build

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes