Clarifai MCP Server Local

🚀 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: ファイルシステム操作などの補助機能を提供します。

リクエストフローの解説

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

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

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

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