Docsscrapermcp

🚀 DocsScraper MCP Server

DocsScraperのウェブAPIに接続し、ドキュメントのチャンクを通じて意味検索機能を提供するMCPサーバーです。

✨ 主な機能

• 意味検索：埋め込み表現とAIによる検証を使用して、ドキュメントのチャンクを検索します。
• API統合：REST APIを介してDocsScraperのウェブアプリケーションに接続します。
• 代替ソース：ローカルに結果が見つからない場合、自動的にスクレイパーのソースにフォールバックします。
• 結果の設定可能：検索結果の数を制御できます（1 - 10、デフォルト: 5）。
• サービスフィルタリング：特定のサービス名で検索結果をフィルタリングできます（大文字小文字を区別しません）。

📦 インストール

npm install
npm run build

📚 ドキュメント

設定

サーバーには以下の環境変数が必要です。

• DOCS_SCRAPER_API_KEY：認証用のAPIキー（必須）

ツール

search_docs

意味検索を使用してドキュメントのチャンクを検索します。

パラメーター：

• query (文字列、必須)：関連するドキュメントを見つけるための検索クエリ
• top (数値、オプション)：返す結果の最大数（1 - 10、デフォルト: 5）
• service (文字列、必須)：結果をフィルタリングするサービス名（大文字小文字を区別しません）

使用例：

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

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

リソース

docs-scraper://api/info

接続されたDocsScraper APIに関する情報を提供します。

• ベースURLの設定
• APIキーの状態
• エンドポイントの詳細
• 認証方法

API統合

このサーバーはDocsScraperのウェブAPIエンドポイントに接続します。

• エンドポイント：GET /api/chunks/search
• 認証：X-API-Keyヘッダーを使用したAPIキー
• パラメーター：query (文字列)、top (数値)、service (文字列、オプション)

検索エンドポイントは以下のように動作します。

1. 埋め込み表現を使用して意味的に類似したチャンクを見つけます。
2. 関連性を確保するためにAIによる検証を適用します。
3. ローカルに結果が見つからない場合、スクレイパーのソースにフォールバックします。
4. スコアとソース情報を含むチャンクを返します。

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 // important, we need a lot of time to do our requests
    }
}

使用方法

このサーバーはMCP互換のクライアントとともに使用するように設計されています。クライアントを適切な環境変数を設定してこのサーバーに接続するように構成してください。

エラーハンドリング

サーバーは一般的な問題に対して詳細なエラーメッセージを提供します。

• 認証失敗 (401)
• 無効なリクエスト (400)
• 接続問題 (ECONNREFUSED)

開発

# サーバーをビルドする
npm run build

# 開発中に変更を監視する
npm run watch

# MCPインスペクターでテストする
npm run inspector