MCP Openvision

🚀 MCP オープンソースプロジェクト

MCPは、強力な画像分析ツールを提供するオープンソースプロジェクトです。このプロジェクトでは、簡単なAPI呼び出しで画像を詳細に分析でき、複数の入力形式と高度なカスタマイズオプションをサポートしています。

🚀 クイックスタート

MCPを使い始めるには、まず依存関係をインストールする必要があります。その後、提供されている image_analysis ツールを使って画像分析を行うことができます。

✨ 主な機能

• 簡単なAPI呼び出しで画像を詳細に分析できます。
• 複数の入力形式（Base64エンコード文字列、URLリンク、ファイルパス）をサポートしています。
• 高度なカスタマイズオプション（Base64入力、カスタムシステムプロンプト）が利用可能です。

📦 インストール

依存関係のインストール

pip install mcp-openvision

💻 使用例

基本的な使用法

# URLからの画像を分析する
result = await image_analysis(
    image="https://example.com/image.jpg",
    query="この画像を説明する"
)

# ローカルファイルからの画像を分析する
result = await image_analysis(
    image="path/to/local/image.jpg",
    query="道路シーン内のすべての交通標識を識別し、運転者にとっての意味を説明する"
)

高度な使用法

Base64による入力

# Base64エンコードされた画像データを使用する
result = await image_analysis(
    image="SGVsbG8gV29ybGQ=...",  # Base64データ
    query="この商品のパッケージデザインを分析し、視認性とブランド認識度を向上させるために改善できる部分を強調する"
)

カスタムシステムプロンプト

# 専門的な分析のためにカスタムシステムプロンプトを追加する
result = await image_analysis(
    image="path/to/local/image.jpg",
    query="この絵画の構成と芸術的技巧を分析し、どのように感情的な影響を生み出しているかを重点的に説明する",
    system_prompt="あなたは専門の美術史家で、絵画技術に関する深い知識を持っています。形式分析に焦点を当て、構図、色、筆触、スタイル要素に注目してください。"
)

入力形式

image_analysis ツールは以下の画像入力形式をサポートしています。

1. Base64エンコード文字列
2. URLリンク - http:// または https:// で始まる必要があります。
3. ファイルパス：
   • 絶対パス：ルートディレクトリから始まる完全なパス（Unix）またはドライブ文字（Windows）
   • 相対パス：現在の作業ディレクトリに対するパス
   • プロジェクトルート付きの相対パス：project_root パラメータでベースディレクトリを指定します。

相対パスの使用

相対ファイルパスを使用する場合、2つの選択肢があります。

1. パスはサーバーを実行する現在の作業ディレクトリに対して指定する必要があります。
2. project_root パラメータを指定することができます。

# 例：相対パスとproject_rootパラメータを使用する
result = await image_analysis(
    image="examples/image.jpg",
    project_root="/path/to/your/project",
    query="この画像には何が含まれていますか？"
)

これは、作業ディレクトリが予測できないアプリケーションや、特定のディレクトリに対するファイル参照を使用したい場合に便利です。

🔧 技術詳細

開発環境の初期化

# リポジトリをクローンする
git clone https://github.com/modelcontextprotocol/mcp-openvision.git
cd mcp-openvision

# 開発用の依存関係をインストールする
pip install -e ".[dev]"

コードのフォーマット

このプロジェクトでは、コードの自動フォーマットにBlackを使用しています。フォーマットはGitHub Actionsで強制されます。

• リポジトリにコミットされたすべてのコードは、自動的にBlackでフォーマットされます。
• 協力リポジトリからのプルリクエスト（PR）ブランチには、フォーマットされたコードが直接コミットされます。
• 外部リポジトリからのPRは、元の形式が保持されます。

テスト方法

# テストスイートを実行する
python -m pytest tests/

📦 リリースフロー

プロジェクトのパッケージ化

# ソース配布物を作成する
python setup.py sdist bdist_wheel

# リリースツールをインストールしてテストする
pip install twine
twine check dist/*

# PyPIにリリースする
twine upload --repository-url https://upload.pypi.org/username/ dist/*

📄 ライセンス

MCPオープンソースプロジェクトはMITライセンスに従っています。詳細なライセンス内容は こちら をクリックして確認できます。

開発者への一言

MCPを使用する際に何か問題が発生した場合や、改善提案がある場合は、GitHub Issues を通じて問題を提出したり、フィードバックを提供してください！