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:

1. Open Cursor Settings
2. Go to Features > MCP Servers
3. Click "+ Add New MCP Server"
4. 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.

*Configuration content*

2. Search (search)

Perform Google web searches and optionally scrape content from results.

*Configuration content*

3. Get Autocomplete (get-autocomplete)

Get Google search autocomplete suggestions for a query.

*Configuration content*

4. Search Maps (search-maps)

Search Google Maps for locations and businesses.

*Configuration content*

5. Search Places (search-places)

Search for places with more detailed information.

*Configuration content*

6. Search News (search-news)

Search for news articles with customizable parameters.

*Configuration content*

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

Retrieve Google reviews for businesses or places.

*Configuration content*

Web Scraping

8. Scrape (scrape)

Extract content from a web page with formatting options.

*Configuration content*

9. Crawl (crawl)

Recursively crawl websites and extract content with customizable parameters.

*Configuration content*

10. Screenshot (screenshot)

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

*Configuration content*

11. Extract (extract)

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

*Configuration content*

Document Conversion

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

Convert documents to plaintext with optional OCR.

*Configuration content*

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

Convert various file formats to PDF.

*Configuration content*

14. Merge PDFs (merge-pdfs)

Combine multiple PDFs into a single document.

*Configuration content*

15. Trim Video (trim-video)

Extract a specific clip from a video.

*Configuration content*

16. Extract Document (extract-document)

Extract specific content from documents in various formats.

*Configuration content*

17. Extract Image (extract-image)

Extract text and information from images.

*Configuration content*

18. Extract Audio (extract-audio)

Transcribe and extract information from audio files.

*Configuration content*

19. Extract Video (extract-video)

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

*Configuration content*

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

Extract metadata from PDF files.

*Configuration content*

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

Update metadata in PDF files.

*Configuration content*

AI

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

Get AI agent completions with optional tool definitions.

*Configuration content*

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

Search a knowledge base for relevant information.

*Configuration content*

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

Add entries to a knowledge base.

*Configuration content*

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

Generate images using AI models.

*Configuration content*

26. Generate Image (generate-image)

Generate images using various AI providers.

*Configuration content*

Developer Tools

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

Execute JavaScript code with optional dependencies.

*Configuration content*

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

Execute Python code with optional dependencies.

*Configuration content*

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:

*Configuration content*

Development

# Install dependencies
npm install

# Build
npm run build

License

MIT License - see LICENSE file for details