Image Description MCP Server

🚀 圖像描述MCP服務器

本項目是一個模型上下文協議（MCP）服務器，藉助xAI的Grok API提供人工智能驅動的圖像分析功能。它為AI助手提供了一個安全的接口，使其能夠利用Grok先進的視覺能力分析圖像。

🚀 快速開始

本MCP服務器為AI助手提供了一個安全的接口，使其能夠利用Grok先進的視覺能力分析圖像。它支持網絡託管的圖像和本地文件，可提供詳細描述、提取技術元數據以及進行光學字符識別（OCR）。

✨ 主要特性

當前實現

• describe_image_url - 分析來自網絡URL的圖像，並提供人工智能生成的描述
• describe_image_file - 分析本地圖像文件，並提供人工智能生成的描述
• extract_text_from_image - 執行OCR以從圖像中提取可讀文本

📦 安裝指南

請參考文件中提供的詳細步驟說明進行安裝。

前提條件

• 啟用了MCP工具包的Docker Desktop
• Docker MCP CLI插件（docker mcp命令）
• 從https://console.x.ai/獲取的Grok API密鑰

💻 使用示例

基礎用法

在Grok4 Code Fast中，你可以提出以下問題：

• "描述這張圖片：https://example.com/image.jpg"
• "這張本地圖片展示了什麼：/path/to/image.png"
• "從這張圖片中提取任何文本：https://example.com/document.jpg"
• "給我這張照片的詳細分析：https://example.com/photo.jpg"
• "你能在這張截圖中讀到什麼文本：https://example.com/screenshot.png"

高級用法

本地測試

# 設置測試環境變量
export GROK_API_KEY="your-grok-api-key"

# 直接運行
python image-description-mcp_server.py

# 測試MCP協議
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python image-description-mcp_server.py

添加新工具

1. 將函數添加到image-description-mcp_server.py中
2. 使用@mcp.tool()進行裝飾
3. 使用新工具名稱更新目錄條目
4. 重新構建Docker鏡像

📚 詳細文檔

故障排除

認證錯誤

• 使用docker mcp secret list驗證密鑰
• 確保GROK_API_KEY設置正確
• 在https://console.x.ai/檢查API密鑰的有效性

圖像處理錯誤

• 確保圖像URL可訪問且有效
• 檢查本地文件路徑是否存在且可讀
• 驗證圖像格式是否受支持（JPEG、PNG、WebP等）

安全注意事項

• 所有密鑰存儲在Docker Desktop密鑰中
• 切勿硬編碼API密鑰
• 在Docker中以非root用戶身份運行
• 圖像在內存中臨時處理
• 不永久存儲圖像數據
• 不記錄敏感數據

API文檔

本服務與xAI的Grok API集成：

• Grok API參考文檔：https://docs.x.ai/docs/api-reference
• MCP SDK文檔：https://github.com/modelcontextprotocol/sdk

數據源

📄 許可證

本項目採用MIT許可證。