facehunch

Facehunch MCP

写真検索のコンテキストと、その明確な限界。

Facehunch は、写真検索の方法、出典ページ、視覚的な検索結果の限界を理解するための情報を読者に提供します。ガイドでは、写真の複製を見つけることと、異なる写真間で顔を比較することを区別しています。ワークスペースでは、架空のサンプルと同意を得た API テストを使用しています。現在の FaceCheck テストインデックスでは、信頼できる身元照合結果は得られません。

ウェブサイト · MCP リポジトリ · エージェントスキル · npm パッケージ

このコネクターの機能

このパッケージは、ローカルの stdio MCP クライアントをホスト型の Facehunch MCP サーバーに接続します。ホスト型ツールは Cloudflare 上で実行されます。ローカルパッケージは接続を仲介し、ブラウザー経由の OAuth を開始します。Worker をデプロイしたり、製品のパスワードをアシスタントに貼り付けたりする必要はありません。

ツール	機能
get_profile	サインイン中のアカウント情報を読み取ります。
list_reports	ステータスとアクセス情報を含め、アカウントがすでに所有しているレポートを一覧表示します。
get_report	ロックされた結果に配慮しながら、所有するレポートのメタデータと利用可能な保存済み出典リンクを取得します。

この MCP は、新たな顔検索を開始したり、人物を特定したり、センシティブな特性を推測したり、個人情報を調査したりすることはありません。既存の所有済みレポートを取得するだけです。ロックされた結果は表示されません。レポート一覧が空の場合は、アカウントに保存済みレポートがないことを意味し、写真がオンラインで見つからないことを意味するわけではありません。テスト結果は身元確認ではありません。

ワークフローの例

1. ユーザーのアカウントにすでに存在するレポートを見つけます。
2. ステータスとアクセス状態を確認し、日付と出典 URL は返されたとおりに正確に保持します。
3. 身元を推測したり、類似度スコアを確認済みの事実として扱ったりせず、保存済みレポートの内容を要約します。

アシスタントへの質問例

保存済みレポートを、日付、ステータス、リンクとあわせて一覧表示してください。

この既存レポートを開き、誰かを特定せずに利用可能な出典リンクを要約してください。

このレポートにアクセスできるか確認してください。ロックされている場合は、内容を推測せず、製品リンクを返してください。

リモート MCP クライアントへの接続

1. クライアントのカスタム MCP またはコネクター設定を開きます。
2. リモートサーバー URL として https://mcp.facehunch.com/mcp を入力します。
3. ブラウザーで Facehunch にサインインし、同意画面に表示される権限を確認します。
4. クライアントに戻り、利用可能なツールを読み込みます。

Streamable HTTP MCP と OAuth に対応したクライアントを使用してください。カスタムコネクターを利用できるかどうかは、クライアントとアカウントによって異なります。リポジトリが公開されていたり npm でリリースされていたりしても、その連携がクライアントのマーケットプレイスで承認されているとは限りません。

Claude Desktop およびその他の stdio クライアント

Node.js 22 以降と、既存の Facehunch アカウントが必要です。クライアントの MCP 設定に次のエントリーを追加します。

{
  "mcpServers": {
    "facehunch": {
      "command": "npx",
      "args": [
        "-y",
        "facehunch-mcp"
      ]
    }
  }
}

ターミナルから npx -y facehunch-mcp を実行して、ブリッジを起動することもできます。これは stdio 経由で MCP を使用するもので、対話型のチャットインターフェースではありません。MCPB 拡張機能に対応したデスクトップクライアントでは、Facehunch のリリースから .mcpb ファイルをダウンロードしてください。

権限とアカウントへのアクセス

要求されるスコープ：profile:read reports:read。以前にプロフィールのみで接続した場合は、コンテンツツールを利用できるように、再接続して追加の権限を明示的に承認する必要があります。

自分で開始した接続のみを承認してください。サインイン時に新しいタブが開いた場合は、そこで手続きを完了し、同意画面に戻って更新してください。接続済みアプリの管理または取り消し。

このパッケージでは、OAuth、PKCE、ローカルトークンの保存に、バージョンが固定されたmcp-remoteを使用します。お使いのコンピューター上のトークンは認証情報です。このコネクターは上記の固定エンドポイントを使用し、コマンドラインによるエンドポイントの上書きを拒否します。このパッケージから、製品のパスワードや基盤となるプロバイダーの認証情報を求められることはありません。

トラブルシューティング

• ツールが表示されない、または権限が不足している場合： ブラウザーの同意画面から再接続し、選択したアカウントを確認してください。
• リストが空の場合： アカウントが想定される項目を所有していることを確認してください。結果が空であることと、リクエストの失敗は異なります。
• リンクからサインインを求められる場合： 対象の製品アカウントでリンクを開いてください。非公開の製品リンクは公開共有リンクではありません。
• ブラウザーで認証がブロックされる場合： ブラウザーに表示されたエラーを確認し、期限切れのリクエストをクライアントからやり直してください。Cookieやトークンをイシューに送信しないでください。

コンパニオンスキルを追加する

Facehunch エージェントスキルでは、適切なレコードの選び方、結果の解釈方法、ワークフローの制限を守る方法について説明しています。

npx skills add facehunch/agent-skill

Facehunch について詳しく知る

• 写真検索とその制限
• 逆画像検索について
• 顔検索と逆画像検索の違い
• 写真検索のプライバシー
• テストモードのヘルプセンター
• 写真の削除

開発とサポート

npm ci
npm test
npm run bundle

コネクターの問題を報告する際は、使用しているクライアント、Node.js のバージョン、機密情報を伏せたエラーを記載してください。リリース時は、package.json、manifest.json、server/config.json、server.json、ロックファイルのバージョンを一致させてください。GitHub Actions がバージョン付き npm パッケージと MCPB アセットを公開します。MIT ライセンスについてはLICENSEをご覧ください。