image-mcp-server

image-mcp-server

日本語の README

画像 URL またはローカルファイルパスを受け取り、GPT-4o-mini モデルを使用して画像の内容を分析する MCP サーバーです。

機能

• 画像 URL またはローカルファイルパスを入力として受け取り、画像の内容を詳細に分析します
• GPT-4o-mini モデルを使用して、高精度な画像認識と説明を行います
• 画像 URL の有効性を確認します
• ローカルファイルから画像を読み込み、Base64 エンコードします

インストール

Smithery 経由でインストール

Smithery 経由で Claude Desktop 用の Image Analysis Server を自動的にインストールするには：

npx -y @smithery/cli install @champierre/image-mcp-server --client claude

手動インストール

# Clone the repository
git clone https://github.com/champierre/image-mcp-server.git # or your forked repository
cd image-mcp-server

# Install dependencies
npm install

# Compile TypeScript
npm run build

設定

このサーバーを使用するには、OpenAI API キーが必要です。次の環境変数を設定してください：

OPENAI_API_KEY=your_openai_api_key

MCP サーバーの設定

Cline などのツールで使用するには、MCP サーバー設定ファイルに次の設定を追加してください：

Cline の場合

cline_mcp_settings.json に次の内容を追加してください：

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

Claude Desktop アプリの場合

claude_desktop_config.json に次の内容を追加してください：

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

使用方法

MCP サーバーを設定すると、次のツールを使用できるようになります：

• analyze_image：画像 URL を受け取り、その内容を分析します。
• analyze_image_from_path：ローカルファイルパスを受け取り、その内容を分析します。

使用例

URL から分析する場合：

Please analyze this image URL: https://example.com/image.jpg

ローカルファイルパスから分析する場合：

Please analyze this image: /path/to/your/image.jpg

注意：ローカルファイルパスの指定

analyze_image_from_path ツールを使用する場合、AI アシスタント（クライアント）はこのサーバーが実行されている環境で有効なファイルパスを指定する必要があります。

• サーバーが WSL で実行されている場合：
  • AI アシスタントが Windows のパス（例：C:\...）を持っている場合は、ツールに渡す前に WSL のパス（例：/mnt/c/...）に変換する必要があります。
  • AI アシスタントが WSL のパスを持っている場合は、そのまま渡せます。
• サーバーが Windows で実行されている場合：
  • AI アシスタントが WSL のパス（例：/home/user/...）を持っている場合は、ツールに渡す前に UNC パス（例：\\wsl$\Distro\...）に変換する必要があります。
  • AI アシスタントが Windows のパスを持っている場合は、そのまま渡せます。

**パスの変換は、AI アシスタント（またはその実行環境）の責任です。**サーバーは、受け取ったパスをそのまま解釈しようとします。

注意：ビルド時の型エラー

npm run build の実行時に、mime-types モジュールの TypeScript 型定義が見つからないというエラー（TS7016）が表示されることがあります。

src/index.ts:16:23 - error TS7016: Could not find a declaration file for module 'mime-types'. ...

これは型チェックエラーです。JavaScript のコンパイル自体は成功するため、サーバーの実行には影響しません。このエラーを解消するには、型定義ファイルを開発用依存関係としてインストールしてください。

npm install --save-dev @types/mime-types
# or
yarn add --dev @types/mime-types

開発

# Run in development mode
npm run dev

ライセンス

MIT