Clarifai MCP Server Local

🚀 Clarifai MCP 服務器項目概述

本項目的 Clarifai MCP 服務器提供了一系列工具和資源接口，實現了從圖像生成到內容檢索的完整功能，通過 MCP 協議對外提供服務，能滿足用戶在圖像生成、搜索等多方面的需求。

✨ 主要特性

• 具備多種工具接口，可實現圖像生成、根據本地文件路徑或網絡 URL 搜索圖像等功能。
• 提供資源接口，支持不同搜索類型和過濾條件，能根據資源 ID 返回具體資源信息。
• 架構清晰，各模塊分工明確，從啟動入口、配置管理到通信邏輯、API 調用等都有相應的模塊負責。

📚 詳細文檔

工具接口

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 協議對外提供服務。