Dumpling AI MCP Server Dumplingai

🚀 技术文档

本技术文档介绍的 API 提供了丰富的功能，涵盖网络数据获取、AI 智能体交互和开发者工具支持等，通过简单的 JSON 请求就能完成复杂任务，可极大提升开发效率。

🚀 快速开始

安装与启动

# 安装依赖项
npm install

# 启动服务器
node index.js

✨ 主要特性

• 网络功能：可获取 YouTube 视频信息、提取 URL 内容、搜索 YouTube 视频及获取视频字幕。
• AI 能力：能使用 AI 智能体生成完成内容，还可在指定知识库中搜索信息。
• 开发者工具：支持执行指定的 JavaScript 代码。
• 错误处理：服务器提供强大的错误处理，包含带 HTTP 状态码的详细错误消息、API 密钥验证、使用 Zod 方案进行输入验证以及具有描述性消息的网络错误处理。

📦 安装指南

# 安装依赖项
npm install

💻 使用示例

基础用法

示例 1: 获取网页内容

{
  "name": "extract-url-content",
  "arguments": {
    "url": "https://example.com/blog/post.html",
    "selector": ".article-content"
  }
}

示例 2: 搜索 YouTube 视频

{
  "name": "search-youtube",
  "arguments": {
    "query": "学习人工智能的基础知识",
    "results": 5,
    "filter": "videos"
  }
}

示例 3: 执行计算任务

{
  "name": "run-js-code",
  "arguments": {
    "code": "function factorial(n) { return n <= 1 ? 1 : n * factorial(n - 1); } console.log(factorial(5));",
    "dependencies": {}
  }
}

📚 详细文档

网络

1. 获取 YouTube 视频信息 (get-youtube-info)

获取 YouTube 视频的详细信息。

{
  "name": "get-youtube-info",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=abc123"
  }
}

2. 提取 URL 内容 (extract-url-content)

从指定的 URL 提取 HTML 或其他内容。

{
  "name": "extract-url-content",
  "arguments": {
    "url": "https://example.com",
    "selector": "#main-content"
  }
}

3. 搜索 YouTube (search-youtube)

在 YouTube 上搜索视频。

{
  "name": "search-youtube",
  "arguments": {
    "query": "学习编程的技巧",
    "results": 10,
    "filter": "videos"
  }
}

4. 获取 YouTube 字幕 (get-youtube-subtitles)

获取指定视频的字幕。

{
  "name": "get-youtube-subtitles",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=abc123"
  }
}

AI

5. 生成智能体完成 (generate-agent-completion)

使用 AI 智能体生成完成内容。

{
  "name": "generate-agent-completion",
  "arguments": {
    "prompt": "如何提高我的网站的 SEO？",
    "model": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 500,
    "context": ["这是一个电子商务网站，销售手工制品。"]
  }
}

6. 搜索知识库 (search-knowledge-base)

在指定的知识库中搜索信息。

{
  "name": "search-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "query": "如何优化数据库性能？",
    "limit": 5,
    "similarityThreshold": 0.7
  }
}

开发者工具

7. 执行 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
  }
}

错误处理

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

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

示例错误响应：

{
  "content": [
    {
      "type": "text",
      "text": "错误：无法获取 YouTube 字幕：404 Not Found"
    }
  ],
  "isError": true
}

🔧 技术细节

服务器提供了强大的错误处理机制，具体如下：

• 详细错误消息：错误消息带有 HTTP 状态码，能让开发者清晰了解错误的具体情况。
• API 密钥验证：通过 API 密钥验证，确保只有授权用户可以使用 API。
• 输入验证：使用 Zod 方案进行输入验证，保证输入数据的合法性和完整性。
• 网络错误处理：对于网络错误，会给出具有描述性的消息，方便开发者排查问题。

示例错误响应展示了错误消息的格式，包含错误文本和错误标识，有助于开发者快速定位和解决问题。