Dumpling AI MCP 服务器

一个模型上下文协议 (MCP) 服务器实现，与 Dumpling AI 集成，用于数据抓取、内容处理、知识管理、AI 代理和代码执行功能。

特性

• 与所有 Dumpling AI API 端点完全集成
• 用于 YouTube 视频文字稿、搜索、自动完成、地图、地点、新闻和评论的数据 API
• 具有抓取、爬取、屏幕截图和结构化数据提取支持的 Web 抓取
• 用于文本提取、PDF 操作、视频处理的文档转换工具
• 从文档、图像、音频和视频中提取数据
• AI 功能，包括代理补全、知识库管理和图像生成
• 用于在安全环境中运行 JavaScript 和 Python 代码的开发者工具
• 自动错误处理和详细的响应格式

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 mcp-server-dumplingai：

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

使用 npx 运行

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

手动安装

npm install -g mcp-server-dumplingai

在 Cursor 上运行

配置 Cursor 🖥️ 注意：需要 Cursor 版本 0.45.6+

要在 Cursor 中配置 Dumpling AI MCP：

1. 打开 Cursor 设置
2. 转到 Features > MCP Servers
3. 单击 "+ Add New MCP Server"
4. 输入以下内容：

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

如果您使用的是 Windows 并且遇到问题，请尝试 cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"

将 your-api-key 替换为您的 Dumpling AI API 密钥。

配置

环境变量

• DUMPLING_API_KEY: 您的 Dumpling AI API 密钥（必需）

可用工具

数据 API

1. 获取 YouTube 视频文字稿 (get-youtube-transcript)

从 YouTube 视频中提取文字稿，可以选择包含时间戳。

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

2. 搜索 (search)

执行 Google 网络搜索，并可以选择从结果中抓取内容。

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

获取 Google 搜索自动完成建议。

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

4. 搜索地图 (search-maps)

在 Google 地图中搜索位置和商家。

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

5. 搜索地点 (search-places)

搜索具有更详细信息的地点。

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

6. 搜索新闻 (search-news)

搜索具有可自定义参数的新闻文章。

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

7. 获取 Google 评论 (get-google-reviews)

检索商家或地点的 Google 评论。

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

Web 抓取

8. 抓取 (scrape)

从网页中提取内容，并提供格式化选项。

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

9. 爬取 (crawl)

递归地爬取网站并提取内容，并提供可自定义的参数。

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

10. 屏幕截图 (screenshot)

捕获网页的屏幕截图，并提供可自定义的视口和格式选项。

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

11. 提取 (extract)

使用 AI 驱动的指令从网页中提取结构化数据。

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

文档转换

12. 文档转文本 (doc-to-text)

将文档转换为纯文本，可以选择使用 OCR。

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

13. 转换为 PDF (convert-to-pdf)

将各种文件格式转换为 PDF。

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

14. 合并 PDF (merge-pdfs)

将多个 PDF 合并为一个文档。

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

15. 裁剪视频 (trim-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)

从各种格式的文档中提取特定内容。

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

17. 提取图像 (extract-image)

从图像中提取文本和信息。

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

18. 提取音频 (extract-audio)

转录并从音频文件中提取信息。

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

19. 提取视频 (extract-video)

从视频中提取内容，包括文字稿、场景和对象。

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

20. 读取 PDF 元数据 (read-pdf-metadata)

从 PDF 文件中提取元数据。

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

21. 写入 PDF 元数据 (write-pdf-metadata)

更新 PDF 文件中的元数据。

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

获取 AI 代理补全，可以选择工具定义。

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

搜索知识库以获取相关信息。

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

24. 添加到知识库 (add-to-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. 生成 AI 图像 (generate-ai-image)

使用 AI 模型生成图像。

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

使用各种 AI 提供商生成图像。

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

开发者工具

27. 运行 JavaScript 代码 (run-js-code)

执行 JavaScript 代码，可以选择依赖项。

{
  "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. 运行 Python 代码 (run-python-code)

执行 Python 代码，可以选择依赖项。

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

错误处理

服务器提供强大的错误处理：

• 带有 HTTP 状态代码的详细错误消息
• API 密钥验证
• 使用 Zod 模式进行输入验证
• 带有描述性消息的网络错误处理

示例错误响应：

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

开发

# 安装依赖
npm install

# 构建
npm run build

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件