Clarifai MCP Server Local

このプロジェクトは非公式のClarifai MCPサーバーで、ローカルの架け橋としてClarifai APIに接続し、画像生成、推論、検索などの機能をサポートし、標準的なMCPプロトコルを通じてクライアントとやり取りします。

画像とビデオ処理開発者ツール #画像生成 #ローカル推論 #APIブリッジ #MCPプロトコル .Go

スコア : 2.5ポイント

ダウンロード数 : 6.5K

更新時間 : 2025-04-28

サイトを開く

Clarifai MCPローカルサーバーとは？

Clarifai MCPローカルサーバーはユーザーのローカルデバイス上で動作するツールで、架け橋として機能し、開発者が標準的なMCPリクエストを通じてClarifai APIとやり取りできるようにします。画像生成、推論、検索などの操作が可能です。

Clarifai MCPローカルサーバーの使い方は？

まずサーバーソフトウェアをダウンロードしてインストールし、次に必要なパラメータ（個人アクセストークンPATなど）を設定し、最後にクライアントからリクエストを送信すると使用を開始できます。

適用シーン

頻繁にClarifai APIを呼び出す必要があり、かつクラウド環境への依存を減らしたい開発者に適しています。特にローカル開発やデバッグシーンに最適です。

主要機能

画像生成

入力されたテキストプロンプトに基づいて高品質の画像を生成し、カスタムモデルの選択をサポートします。

ファイルパスによる画像推論

ローカル画像をアップロードし、指定されたモデルで分析し、検出された概念ラベルを返します。

URLによる画像推論

ネットワークアドレスから直接画像をアップロードして推論を行い、分析結果を返します。

入力検索

テキスト、ファイルパスまたはURLを通じてClarifai内の入力データを検索することをサポートします。

リソース読み取り

モデルリスト、バージョン情報など、さまざまなリソースの読み取り専用アクセスインターフェースを提供します。

利点

クラウド環境への依存を減らし、プライバシー保護を向上させます。

ローカルでの迅速なデバッグとテストをサポートします。

主流のMCPクライアントフレームワークと互換性があります。

制限

高負荷タスクを処理するにはローカルコンピューターに一定のハードウェア性能が必要です。

承認されたClarifaiアカウントでの使用に限定されます。

バージョンの更新を手動で維持する必要があります。

使い方

サーバーのダウンロードとインストール

GitHubリポジトリをクローンし、Go言語でコンパイルしてバイナリファイルを生成します。

サーバーの設定

設定ファイルを編集して個人アクセストークン(PAT)やその他必要なパラメータを追加します。

サーバーの起動

生成されたバイナリファイルを実行してリクエストの監視を開始します。

使用例

3枚の猫の画像を生成する

サーバーにリクエストを送信して3枚の異なるスタイルの猫の画像を生成します。

類似画像を検索する

画像をアップロードしてClarifaiデータベース内の類似画像を検索します。

よくある質問

個人アクセストークン(PAT)を取得する方法は？

サーバーはどのオペレーティングシステムをサポートしていますか？

接続に失敗した場合はどうすればいいですか？

🚀 Clarifai MCP サーバープロジェクト概要

このプロジェクトは、Clarifai MCP サーバーに関するもので、画像生成や画像検索などの機能を提供し、MCP プロトコルを通じて外部にサービスを提供します。

✨ 主な機能

ツールインターフェース

generate_image

機能説明: 与えられたテキストを使用して画像を生成します。
入力パラメータ:
- prompt (string): テキストプロンプト。例: "a beautiful sunset over the mountains"
- width (int, オプション): 画像の幅。デフォルトは 512。
- height (int, オプション): 画像の高さ。デフォルトは 512。
- quality (string, オプション): 画像の品質。選択可能な値は "standard", "high", "ultra" です。
出力結果:
- 生成された画像ファイルのパスを返します。

clarifai_image_by_path

機能説明: ローカルファイルパスに基づいて、Clarifai プラットフォーム上の画像を検索します。
入力パラメータ:
- filepath (string): 画像ファイルのローカルパス。
- width (int, オプション): 検索結果の幅の要求。
- height (int, オプション): 検索結果の高さの要求。
出力結果:
- 一致する画像のリストを返します。

clarifai_image_by_url

機能説明: ネットワーク URL アドレスに基づいて、Clarifai プラットフォーム上の画像を検索します。
入力パラメータ:
- url (string): 画像を含むネットワークアドレス。
- width (int, オプション): 検索結果の幅の要求。
- height (int, オプション): 検索結果の高さの要求。
出力結果:
- 一致する画像のリストを返します。

リソースインターフェース

リソースリスト要求（resources/list）

URI パラメータを使用して、異なる検索タイプを指定できます。
- /search/text: テキスト内容による検索
- /search/url: ネットワークリンクによる検索
クエリパラメータを使用して、フィルタ条件を指定できます。例えば width, height, format など。

リソース読み取り要求（resources/read）

与えられたリソース ID に基づいて、具体的なリソース情報を返します。

🔧 技術詳細

プロジェクトアーキテクチャの解説

cmd/server: 起動エントリーポイントで、設定の初期化とハンドラーの登録を行います。
config: コマンドライン引数を処理し、PAT や出力パスなどの設定を保存します。
mcp: MCP プロトコルの通信ロジックを担当し、標準入力/出力で JSON-RPC リクエストを処理します。
clarifai: gRPC クライアントロジックをラッピングし、Clarifai API を呼び出すために使用され、認証機能（PAT をリクエストヘッダーに追加）を含みます。
tools: 各 MCP ツールハンドラー（generate_image、clarifai_image_by_path など）を実装し、clarifai クライアントを使用して具体的な操作を行います。
resources: MCP リソース関連のリクエスト（resources/list や resources/read）を処理し、Clarifai API を呼び出してデータを取得します。
utils: ファイルシステム操作などの補助機能を提供します。

リクエストフローの解説

クライアントがサーバーに JSON-RPC リクエストを送信します。
サーバーがリクエストを解析し、タイプに応じて異なるハンドラーに振り分けます。
ハンドラーが Clarifai API を呼び出して具体的な操作を実行します。
結果がクライアントに返されます。

システムアーキテクチャとコンポーネントの関係

cmd/server -> 起動と初期化設定を担当します。
config -> 実行時の設定を保存します。
mcp -> 通信層で、プロトコルの詳細を処理します。
clarifaiclient -> API 呼び出しロジックをラッピングします。
tools -> 具体的なツールリクエスト（画像生成など）を処理します。
resources -> リソース関連のリクエスト（検索など）を処理します。
utils -> ファイル操作などの補助機能を提供します。

以上のモジュールとインターフェースにより、このシステムは画像生成から内容検索までの完全な機能を実現し、MCP プロトコルを通じて外部にサービスを提供します。