Hachimi Image Search

Hachimi Image Search MCP Server

概要

Hachimi Image Search API が MCP プロトコルに対応しました。MCP プロトコルに対応した AI アシスタント（Claude、Cursor、およびその他の互換クライアントなど）は、このサービスを通じて Pexels の画像検索機能をすばやく利用できます。

本サービスは Spring AI MCP Java SDK をベースに開発されており、柔軟な画像検索ツールを提供します。

🛠️ ツール一覧

• searchImage(query)

  • 説明：キーワードで画像を検索します。
  • 入力: query (検索キーワード)
  • 出力: デフォルトの枚数の画像リンク (カンマ区切り)

• searchImageWithCount(query, count)

  • 説明：キーワードで指定した枚数の画像を検索します。
  • 入力: query (検索キーワード), count (画像の枚数, 1-20)
  • 出力: 指定した枚数の画像リンク (カンマ区切り)

• searchFewImages(query)

  • 説明：少数（3枚）の画像をすばやく検索します。
  • 入力: query (検索キーワード)
  • 出力: 3枚の画像リンク (カンマ区切り)

• searchManyImages(query)

  • 説明：多め（12枚）の画像を検索します。
  • 入力: query (検索キーワード)
  • 出力: 12枚の画像リンク (カンマ区切り)

• searchSingleImage(query)

  • 説明：画像を1枚だけ検索します。
  • 入力: query (検索キーワード)
  • 出力: 1枚の画像リンク

🚀 クイックスタート

前提条件

• Java 21 以降
• Pexels API Key（Pexels API から無料で取得できます）

1. インストール

プロジェクトをローカルにクローンします：

git clone https://github.com/Marisalice114/hachimi-image-search-mcp-server.git
cd hachimi-image-search-mcp-server

2. ビルド

Maven を使ってプロジェクトをパッケージ化します：

mvn clean package

成功すると、target ディレクトリに hachimi-image-search-mcp-server-0.0.1-SNAPSHOT.jar ファイルが生成されます。

3. 使用方法

MCP クライアント（Cherry Studio など）の MCP サーバー設定に、以下の JSON 設定を追加します。

Stdio モード（推奨）

このモードでは標準入力／出力を介して通信するため、設定が簡単です。

{
  "mcpServers": {
    "hachimi-image-search-mcp-server": {
      "command": "java",
      "args": [
        "-Dspring.profiles.active=local,stdio",
        "-jar",
        "path/to/hachimi-image-search-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "PEXELS_API_KEY": "YOUR_PEXELS_API_KEY"
      }
    }
  }
}

SSE (Server-Sent Events) モード

このモードでは HTTP SSE を介して通信するため、ポートを公開する必要があります。

{
  "mcpServers": {
    "hachimi-image-search-mcp-server": {
      "command": "java",
      "args": [
        "-Dspring.profiles.active=local,sse",
        "-jar",
        "path/to/hachimi-image-search-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "PEXELS_API_KEY": "YOUR_PEXELS_API_KEY"
      },
      "mcp": {
         "port": 8080,
         "protocol": "http"
      }
    }
  }
}

重要な注意事項:

• path/to/ を、プロジェクト内の jar ファイルの 絶対パス に置き換えてください。
• YOUR_PEXELS_API_KEY を、ご自身の Pexels API キーに置き換えてください。
• local プロファイルを有効にするのは、application-local.yml で定義されている pexels.api-key 設定を読み込むためです。

⚙️ 設定の詳細

Spring Profiles

プロジェクトでは Spring Profiles を使って、実行環境を管理します：

• stdio: 標準入力／出力の通信モードを有効にします。
• sse: SSE 通信モードを有効にします。サービスは 8080 ポートをリッスンします。
• local: application-local.yml 設定ファイルを読み込み、PEXELS_API_KEY を注入します。

起動時には、local,stdio や local,sse のように、local と必要な通信モードを組み合わせて指定してください。

環境変数

JSON 設定に記述する代わりに、環境変数から API キーを直接設定することもできます。

export PEXELS_API_KEY="YOUR_PEXELS_API_KEY"

この場合、JSON 設定から env 部分を削除できます。