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.
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:
- Abra as Configurações do Cursor
- Vá para Recursos > Servidores MCP
- Clique em "+ Adicionar Novo Servidor MCP"
- 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