Dumpling AI MCP Server Dumplingai

🚀 技術文檔

本技術文檔所涉及的 API 提供了豐富的功能，涵蓋網絡數據獲取、AI 智能體交互和開發者工具支持等方面。通過簡單的 JSON 請求，就能完成複雜的任務，極大提升了開發效率。

🚀 快速開始

安裝與啟動

# 安裝依賴項
npm install

# 啟動服務器
node index.js

✨ 主要特性

• 網絡功能豐富：可獲取 YouTube 視頻信息、提取 URL 內容、搜索 YouTube 視頻及獲取字幕。
• AI 能力支持：能使用 AI 智能體生成完成內容，還可在知識庫中搜索信息。
• 開發者工具實用：支持執行指定的 JavaScript 代碼。
• 強大的錯誤處理：提供帶有 HTTP 狀態碼的詳細錯誤消息、API 密鑰驗證、使用 Zod 方案進行輸入驗證以及具有描述性消息的網絡錯誤處理。

📦 安裝指南

# 安裝依賴項
npm install

# 啟動服務器
node index.js

💻 使用示例

基礎用法

示例 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
}

🔧 技術細節

該 API 通過簡單的 JSON 請求來實現各項功能。在網絡方面，利用相關的網絡請求庫來獲取 YouTube 視頻信息、提取 URL 內容等；在 AI 部分，藉助 AI 智能體模型進行內容生成和知識庫搜索；對於開發者工具，提供了執行 JavaScript 代碼的環境。同時，在錯誤處理上，採用了一系列的驗證和處理機制，確保系統的穩定性和可靠性。