Image Description MCP Server

🚀 画像記述MCPサーバー

xAIのGrok APIを使用してAIによる画像分析を提供するModel Context Protocol (MCP) サーバーです。

🚀 クイックスタート

このMCPサーバーは、Grokの高度なビジョン機能を使用してAIアシスタントが画像を分析するための安全なインターフェースを提供します。ウェブ上の画像とローカルファイルの両方をサポートし、詳細な説明、技術的なメタデータの抽出、光学文字認識 (OCR) を提供します。

✨ 主な機能

現在の実装

• describe_image_url - ウェブのURLから画像を分析し、AIによって生成された説明を提供します。
• describe_image_file - ローカルの画像ファイルを分析し、AIによって生成された説明を提供します。
• extract_text_from_image - OCRを実行して、画像から読み取り可能なテキストを抽出します。

📦 インストール

ファイルに付属の手順を参照してください。

💻 使用例

基本的な使用法

Grok4 Code Fastでは、以下のように質問できます。

• "Describe this image: https://example.com/image.jpg"
• "What does this local image show: /path/to/image.png"
• "Extract any text from this image: https://example.com/document.jpg"
• "Give me a detailed analysis of this photo: https://example.com/photo.jpg"
• "What text can you read in this screenshot: https://example.com/screenshot.png"

高度な使用法

ローカルテスト

# Set environment variables for testing
export GROK_API_KEY="your-grok-api-key"

# Run directly
python image-description-mcp_server.py

# Test MCP protocol
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ではルートユーザーで実行しないでください。
• 画像は一時的にメモリ内で処理されます。
• 画像データは永続的に保存されません。
• 機密データはログに記録されません。

APIドキュメント

このサービスはxAIのGrok APIと統合されています。

• Grok APIリファレンス: https://docs.x.ai/docs/api-reference
• MCP SDKドキュメント: https://github.com/modelcontextprotocol/sdk

データソース

📄 ライセンス

MITライセンス