Docsscrapermcp

🚀 DocsScraper MCP 服務器

DocsScraper MCP 服務器可連接到 DocsScraper 網絡 API，通過文檔片段提供語義搜索功能。

✨ 主要特性

• 語義搜索：利用嵌入向量和人工智能驗證技術，對文檔片段進行搜索。
• API 集成：通過 REST API 連接到你的 DocsScraper 網絡應用程序。
• 備用源：當本地沒有搜索結果時，自動回退到抓取源。
• 可配置結果：控制搜索結果的數量（範圍為 1 - 10，默認值為 5）。
• 服務過濾：按特定服務名稱過濾搜索結果（不區分大小寫）。

📦 安裝指南

npm install
npm run build

💻 使用示例

基礎用法

在 mcp.json 中進行配置：

{
  "mcpServers": {
    "docs-scraper": {
      "command": "node",
      "args": [
        "/Users/tanevanwifferen/Documents/Cline/MCP/docs-scraper-server/build/index.js"
      ],
      "env": {
        "DOCS_SCRAPER_API_KEY": "###",
        "DOCS_SCRAPER_BASE_URL": "https://api.mcpdocsscraper.click"
      },
      "disabled": false,
      "alwaysAllow": [
        "search_docs"
      ],
      "timeout": 900 // 重要，我們需要足夠的時間來處理請求
    }
}

高級用法

使用 search_docs 工具進行語義搜索：

{
  "query": "how to configure authentication",
  "service": "Binance",
  "top": 3
}

{
  "query": "React hooks documentation",
  "top": 5,
  "service": "React"
}

📚 詳細文檔

工具

search_docs

通過語義搜索在文檔片段中進行查找。

參數：

• query（字符串，必需）：用於查找相關文檔的搜索查詢。
• top（數字，可選）：返回結果的最大數量（範圍為 1 - 10，默認值為 5）。
• service（字符串，必需）：用於過濾結果的服務名稱（不區分大小寫）。

資源

docs-scraper://api/info

提供有關已連接的 DocsScraper API 的信息，包括：

• 基礎 URL 配置
• API 密鑰狀態
• 端點詳情
• 認證方法

API 集成

此服務器連接到 DocsScraper 網絡 API 端點：

• 端點：GET /api/chunks/search
• 認證：通過 X-API-Key 頭部使用 API 密鑰進行認證。
• 參數：query（字符串）、top（數字）、service（字符串，可選）

搜索端點的工作流程：

1. 使用嵌入向量查找語義相似的片段。
2. 應用人工智能驗證以確保相關性。
3. 如果本地沒有搜索結果，則回退到抓取源。
4. 返回帶有分數和源信息的片段。

使用說明

該服務器旨在與 MCP 兼容的客戶端一起使用。請配置你的客戶端，設置適當的環境變量以連接到該服務器。

錯誤處理

服務器針對常見問題提供詳細的錯誤消息：

• 認證失敗（401）
• 無效請求（400）
• 連接問題（ECONNREFUSED）

開發

# 構建服務器
npm run build

# 在開發過程中監聽文件變化
npm run watch

# 使用 MCP 檢查器進行測試
npm run inspector