Clarity MCP Bootleg Market

Clarity MCP 闇市場

ブラウザーの通信をツール呼び出しに変換します。ネットワークリクエストを MCP に密輸しましょう。

これは何ですか？

Model Context Protocol（MCP）が必要になったら、Clarity をご利用ください。当サーバーは、HAR ファイルから抽出した Web API を使って、Claude のような AI アシスタントを接続します。Web サイトの機能を「借りて」、AI が使える形にする方法だとお考えください。

仕組み

sequenceDiagram
    participant Client as MCP Client (Claude)
    participant Server as Clarity Server
    participant Backend as Clarity Backend
    participant API as Target Web APIs

    note over Client,API: HAR File Processing
    Backend->>Backend: Process HAR file
    Backend->>Backend: Extract API endpoints
    Backend->>Backend: Generate tools with AI
    Backend->>Backend: Store in database

    note over Client,API: Runtime Flow
    Client->>Server: Connect via stdio
    Client->>Server: ListTools request
    Server->>Backend: Forward request
    Backend->>Server: Return available tools
    Server->>Client: Deliver tools to client

    Client->>Server: CallTool request
    Server->>Server: Transform tool name
    Server->>Backend: Forward to backend
    Backend->>API: Execute API call
    API->>Backend: Return response
    Backend->>Server: Return result
    Server->>Client: Deliver to client

インストール

# Install the package
npm install -g @lekt9/clarity-mcp

# Set up your credentials
export CLARITY_API_KEY=your_api_key
# Optional: Specify a specific MCP ID if you have multiple MCPs
export CLARITY_MCP_ID=your_mcp_id

# Run the server
clarity-mcp

MCP の作成

HAR ファイルから独自の Model Context Protocol を作成するには：

1. https://www.theclarityproject.net にアクセスします
2. HAR ファイルをアップロードします
3. プラットフォームがファイルを処理し、必要なツールを生成します
4. Web サイトから API キーを取得します

アンダーグラウンド MCP 市場

プレミアムエージェントツール

MCP は AI エージェントが求める秘密のスパイスです。これらの Model Context Protocol は、エージェントが外部サービスとやり取りし、リアルタイムデータを取得するために使う強力なツールです。MCP がなければ、AI は自分の殻に閉じ込められてしまいます。

おしゃれに装った API

率直に言えば、MCP はおしゃれな服を着せた API にすぎません。他の API と同じように OpenAPI 仕様に従っていますが、AI が利用しやすいようにきれいにパッケージ化されています。同じ製品でも、包装が違うだけ――まさにマーケティングの妙です。

優れた機能をリバースエンジニアリング

あらゆる Web サイトは、常にネットワークリクエストを送信しています。適切なツールがあれば、これらのリクエストを取得してリバースエンジニアリングし、API の海賊版を独自に作成できます。誰かのプレミアムコンテンツをコピーするようなものです。

通信からプレミアム MCP へ

当システムは、一般的な HAR ファイルを高品質な MCP に変換し、あらゆる AI エージェントが大金を払ってでも手に入れたくなるものを作成します。エンドポイント、パラメーター、レスポンスを分析して、ツールが利用できる完璧な複製を作成します。

Tip：AI エージェントがツールを使うとき、MCP を通じて API を呼び出しています。こうしたプロトコルを作成すれば、AI の機能を拡張し、事実上あらゆるデジタルサービスとやり取りできるようになります。

密輸ガイド

HAR（HTTP Archive）ファイルには、Web サイトを操作している間にブラウザーが行うすべてのネットワークリクエストが記録されます。作成するには、次の手順に従ってください。

ステップ 1：開発者ツールを開く

Web ページの任意の場所を右クリックし、「検証」または「要素を検証」を選択します。または、次のキーボードショートカットを使います。

• Chrome/Edge/Firefox（Windows）：F12 または Ctrl+Shift+I
• Chrome/Edge/Firefox（Mac）：Option+Cmd+I
• Safari（Mac）：最初に「開発」メニューを有効にします（Safari > 環境設定 > 詳細 > 「開発」メニューを表示）。その後、Option+Cmd+I を押します

ステップ 2：ネットワークアクティビティを記録する

開発者ツールパネルで、「ネットワーク」タブを開きます。

• 記録が有効になっていることを確認します（通常は赤い丸のアイコンです）。
• ページの読み込みをまたいでリクエストを保持するには、「ログを保持」オプションをオンにします。
• 任意：より整理されたキャプチャにするには、クリアアイコンを使って既存のログを消去します。
• 取得したい API 呼び出しが発生する操作（ログイン、データの読み込み、フォームの送信など）を Web サイト上で行います。

目的のリクエストがすべて記録されるよう、サイトを十分に操作してください。

ステップ 3：HAR ファイルをエクスポートする

必要なアクティビティを取得したら、ネットワークリクエストの一覧の任意の場所を右クリックします。

• 「コンテンツ付きですべてを HAR として保存」（または「HAR をエクスポート…」など同様の表記）を選択します。
• .har ファイルの保存先を選びます。

これで、Clarity の Web サイトにあるアップローダーから HAR ファイルをアップロードできます。

Important：HAR ファイルには、Cookie、認証トークン、個人データなどの機密情報が含まれる場合があります。安全に取り扱い、公開の場で共有しないでください。

Claude での使用方法

1. Claude Desktop アプリケーションをインストールします
2. Claude の設定を開き、MCP セクションに移動します
3. 次のコマンドで新しい MCP サーバーを追加します：

   npx -y @smithery/cli@latest install @lekt9/clarity-mcp --claude
   

4. Claude との会話を開始し、Clarity MCP が提供するツールを使います

環境変数

• CLARITY_API_KEY：Clarity バックエンドとの認証に使用する API キー
• CLARITY_MCP_ID：使用する MCP を指定する任意の MCP ID（複数の MCP がある場合に便利です）
• NEXTJS_APP_URL：Clarity バックエンドの URL（デフォルトは https://clarity.org/）

技術詳細

アーキテクチャ

このサーバーは、シンプルなプロキシアーキテクチャを採用しています。

1. MCP プロトコル処理：クライアントとの通信に MCP プロトコルを実装します
2. リクエスト転送：クライアントのリクエストを Clarity バックエンドに転送します
3. レスポンス変換：MCP プロトコルの要件に合わせてレスポンスを変換します

主要コンポーネント

• サーバークラス：MCP SDK を使用したメインのサーバー実装
• リクエストハンドラー：ListTools および CallTool リクエストを処理するハンドラー
• 名前変換：命名規則を相互に変換する関数
• エラー処理：適切なエラーの伝播と処理

開発

開発モードでサーバーを実行するには：

# Clone the repository
git clone https://github.com/lekt9/clarity-mcp.git
cd clarity-mcp

# Install dependencies
npm install

# Build the server
npm run build

制限事項

• バックエンドへの認証済みリクエストには、有効な API キーが必要です
• ツールの実行は、Clarity バックエンドが利用可能かどうかに依存します
• サーバーはツールの定義や結果をキャッシュしません

ライセンス

MIT