Pathscan MCP Server

🚀 クイックスタート

このドキュメントでは、MCPサービスを構築し、clineで使用するまでの手順を説明します。

📦 インストール

1. dirsearchの依存関係のインストール

dirsearchディレクトリに移動し、依存関係をグローバル環境にインストールします。

pip install -r .\requirements.txt

2. グローバル環境への追加インストール

pip install setuptools

3. uvマネージャーのインストール

これはRustで書かれた非常に高速なPythonパッケージとプロジェクトマネージャーです。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

4. MCPサービスの依存関係のインストール

uv sync

5. firecrawlのローカルデプロイ

これはAIクローラーツールで、データクリーニング機能を備え、ローカルのDockerでのデプロイをサポートしています。

参考記事:

• https://www.cnblogs.com/skystrive/p/18893148
• https://docs.firecrawl.dev/contributing/guide

トラブルシューティング: ローカルでデプロイしたfirecrawlを使用してウェブページをクロールする際にUnauthorizedが返された場合の解決策: .env設定ファイルのUSE_DB_AUTHENTICATIONフィールドをfalseに設定します。

提供された.envファイルを直接使用することができます。

firecrawlが正常に動作していることをテストするには、次のURLを開きます: http://{firecrawl server IP}:3002/test

Hello, world!が表示されれば、サービスが正常に動作しています。

6. config.pyファイルの編集

FIRECRAWL_HOSTはfirecrawlが動作しているホストアドレスです。 GLOBAL_PYTHON_PATHはグローバルなPythonのパスです。グローバルなPythonのパスを取得するには、コマンドプロンプトでwhere pythonと入力します。

7. MCPサービスの起動

uv run main.py

以下のようなログが表示されれば、サービスが正常に起動しています。

8. clineへのサービスの追加

設定ファイルを直接編集します。

{
    "mcpServers": {
        "path scanner": {
            "url": "http://127.0.0.1:8000/sse",
            "disabled": false,
            "autoApprove": [],
            "timeout": 1800
        }
    }
}

これで、MCPサーバーをclineで使用できるようになります。

💻 使用例

基本的な使用法

# サイトセキュリティアシスタントを使用して指定されたサイトをスキャンする
# このプロンプトに従って、MCPサービスを使用して指定されたサイトをスキャンし、構造化された結果（表形式）を返します。
# 以下の情報を抽出してまとめます：
# - サイトで使用されている技術スタック
# - スキャンレポートのリスクレベルに基づいて、サイトの脆弱性情報を分類整理（高リスク/中リスク/低リスク）
# - レポートで高リスクの脆弱性としてマークされたURLのページコンテンツを読み取り、コンテンツの要約を生成
# - 最終的にデータを以下の構造で出力

# 技術スタック
# 脆弱性情報（深刻度別に分類）
# 高リスク脆弱性関連のURLとコンテンツ要約
# 対象サイトURL: 

🔧 技術詳細

エラー解消

サーバーが初期化されていない状態でクライアントからのリクエストを受け取った場合の解決策: サービスを正式に使用する前に、サービスを初期化します。

参考情報

このプロジェクトは、ai_dirscanプロジェクトにインスパイアされています。

效果展示