Dumpling AI MCP Server

A Model Context Protocol (MCP) server implementation that integrates with Dumpling AI for data scraping, content processing, knowledge management, AI agents, and code execution capabilities.

Features

Complete integration with all Dumpling AI API endpoints
Data APIs for YouTube transcripts, search, autocomplete, maps, places, news, and reviews
Web scraping with support for scraping, crawling, screenshots, and structured data extraction
Document conversion tools for text extraction, PDF operations, video processing
Extract data from documents, images, audio, and video
AI capabilities including agent completions, knowledge base management, and image generation
Developer tools for running JavaScript and Python code in a secure environment
Automatic error handling and detailed response formatting

Installation

Installing via Smithery

To install mcp-server-dumplingai for Claude Desktop automatically via Smithery:

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

Running with npx

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

Manual Installation

npm install -g mcp-server-dumplingai

Running on Cursor

Configuring Cursor 🖥️ Note: Requires Cursor version 0.45.6+

To configure Dumpling AI MCP in Cursor:

Open Cursor Settings
Go to Features > MCP Servers
Click "+ Add New MCP Server"
Enter the following:

{
  "mcpServers": {
    "dumplingai": {
      "command": "npx",
      "args": ["-y", "mcp-server-dumplingai"],
      "env": {
        "DUMPLING_API_KEY": "<your-api-key>"
      }
    }
  }
}

If you are using Windows and are running into issues, try cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"

Replace your-api-key with your Dumpling AI API key.

Configuration

Environment Variables

DUMPLING_API_KEY: Your Dumpling AI API key (required)

Available Tools

Data APIs

1. Get YouTube Transcript (`get-youtube-transcript`)

Extract transcripts from YouTube videos with optional timestamps.

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

2. Search (`search`)

Perform Google web searches and optionally scrape content from results.

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

3. Get Autocomplete (`get-autocomplete`)

Get Google search autocomplete suggestions for a query.

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

4. Search Maps (`search-maps`)

Search Google Maps for locations and businesses.

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

5. Search Places (`search-places`)

Search for places with more detailed information.

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

6. Search News (`search-news`)

Search for news articles with customizable parameters.

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

7. Get Google Reviews (`get-google-reviews`)

Retrieve Google reviews for businesses or places.

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

Web Scraping

8. Scrape (`scrape`)

Extract content from a web page with formatting options.

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

9. Crawl (`crawl`)

Recursively crawl websites and extract content with customizable parameters.

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

10. Screenshot (`screenshot`)

Capture screenshots of web pages with customizable viewport and format options.

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

11. Extract (`extract`)

Extract structured data from web pages using AI-powered instructions.

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

Document Conversion

12. Doc to Text (`doc-to-text`)

Convert documents to plaintext with optional OCR.

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

13. Convert to PDF (`convert-to-pdf`)

Convert various file formats to PDF.

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

14. Merge PDFs (`merge-pdfs`)

Combine multiple PDFs into a single document.

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

15. Trim Video (`trim-video`)

Extract a specific clip from a video.

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

16. Extract Document (`extract-document`)

Extract specific content from documents in various formats.

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

17. Extract Image (`extract-image`)

Extract text and information from images.

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

18. Extract Audio (`extract-audio`)

Transcribe and extract information from audio files.

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

19. Extract Video (`extract-video`)

Extract content from videos including transcripts, scenes, and objects.

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

20. Read PDF Metadata (`read-pdf-metadata`)

Extract metadata from PDF files.

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

21. Write PDF Metadata (`write-pdf-metadata`)

Update metadata in PDF files.

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

AI

22. Generate Agent Completion (`generate-agent-completion`)

Get AI agent completions with optional tool definitions.

{
  "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. Search Knowledge Base (`search-knowledge-base`)

Search a knowledge base for relevant information.

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

24. Add to Knowledge Base (`add-to-knowledge-base`)

Add entries to a knowledge base.

{
  "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. Generate AI Image (`generate-ai-image`)

Generate images using AI models.

{
  "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. Generate Image (`generate-image`)

Generate images using various AI providers.

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

Developer Tools

27. Run JavaScript Code (`run-js-code`)

Execute JavaScript code with optional dependencies.

{
  "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. Run Python Code (`run-python-code`)

Execute Python code with optional dependencies.

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

Error Handling

The server provides robust error handling:

Detailed error messages with HTTP status codes
API key validation
Input validation using Zod schemas
Network error handling with descriptive messages

Example error response:

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

Development

# Install dependencies
npm install

# Build
npm run build

License

MIT License - see LICENSE file for details

Dumpling AI MCP Server

Dumpling AI MCP Server

Features

Installation

Installing via Smithery

Running with npx

Manual Installation

Running on Cursor

Configuration

Environment Variables

Available Tools

Data APIs

1. Get YouTube Transcript (get-youtube-transcript)

2. Search (search)

3. Get Autocomplete (get-autocomplete)

4. Search Maps (search-maps)

5. Search Places (search-places)

6. Search News (search-news)

7. Get Google Reviews (get-google-reviews)

Web Scraping

8. Scrape (scrape)

9. Crawl (crawl)

10. Screenshot (screenshot)

11. Extract (extract)

Document Conversion

12. Doc to Text (doc-to-text)

13. Convert to PDF (convert-to-pdf)

14. Merge PDFs (merge-pdfs)

15. Trim Video (trim-video)

16. Extract Document (extract-document)

17. Extract Image (extract-image)

18. Extract Audio (extract-audio)

19. Extract Video (extract-video)

20. Read PDF Metadata (read-pdf-metadata)

21. Write PDF Metadata (write-pdf-metadata)

AI

22. Generate Agent Completion (generate-agent-completion)

23. Search Knowledge Base (search-knowledge-base)

24. Add to Knowledge Base (add-to-knowledge-base)

25. Generate AI Image (generate-ai-image)

26. Generate Image (generate-image)

Developer Tools

27. Run JavaScript Code (run-js-code)

28. Run Python Code (run-python-code)

Error Handling

Development

License

Related Servers

Bright Data

Scrapfly

Deepwiki

powhttp-mcp

DidItChange

MCP Web Research Server

Web Scout

Puppeteer

LinkedIn

YouTube Transcript

Cloudflare Browser Rendering

1. Get YouTube Transcript (`get-youtube-transcript`)

2. Search (`search`)

3. Get Autocomplete (`get-autocomplete`)

4. Search Maps (`search-maps`)

5. Search Places (`search-places`)

6. Search News (`search-news`)

7. Get Google Reviews (`get-google-reviews`)

8. Scrape (`scrape`)

9. Crawl (`crawl`)

10. Screenshot (`screenshot`)

11. Extract (`extract`)

12. Doc to Text (`doc-to-text`)

13. Convert to PDF (`convert-to-pdf`)

14. Merge PDFs (`merge-pdfs`)

15. Trim Video (`trim-video`)

16. Extract Document (`extract-document`)

17. Extract Image (`extract-image`)

18. Extract Audio (`extract-audio`)

19. Extract Video (`extract-video`)

20. Read PDF Metadata (`read-pdf-metadata`)

21. Write PDF Metadata (`write-pdf-metadata`)

22. Generate Agent Completion (`generate-agent-completion`)

23. Search Knowledge Base (`search-knowledge-base`)

24. Add to Knowledge Base (`add-to-knowledge-base`)

25. Generate AI Image (`generate-ai-image`)

26. Generate Image (`generate-image`)

27. Run JavaScript Code (`run-js-code`)

28. Run Python Code (`run-python-code`)