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
```\n\n### Running with npx
```bash
env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingai
```\n\n### Manual Installation
```bash
npm install -g mcp-server-dumplingai
```\n\n### 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:
```json
{
  "mcpServers": {
    "dumplingai": {
      "command": "npx",
      "args": ["-y", "mcp-server-dumplingai"],
      "env": { "DUMPLING_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)
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)\n\n### Web Scraping
8. Scrape (scrape)
9. Crawl (crawl)
10. Screenshot (screenshot)
11. Extract (extract)\n\n### 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)\n\n### 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)\n\n### Developer Tools
27. Run JavaScript Code (run-js-code)
28. Run Python Code (run-python-code)

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

Development

npm install\n\n# Build
npm run build

License

MIT License - see LICENSE file for details