MCP Meilisearch

🚀 Meilisearch MCP サーバー（Go）

このプロジェクトは、Go言語で構築されたMeilisearch検索エンジンのラッパーで、MCP（モデルコンテキストプロトコル）サーバーとして動作します。大型言語モデル（例えばClaude）がMeilisearchの強力な検索機能を利用できるようになります。

🚀 クイックスタート

このプロジェクトは、Goで書かれたアプリケーションで、Meilisearch検索エンジンをMCP（モデルコンテキストプロトコル）サーバーとして使用できるようにします。MCPサーバーを通じて、Claudeなどの大型言語モデルがMeilisearchの強力な検索機能にアクセスできます。

✨ 主な機能

• Goで実装された軽量かつ高速なMCPサーバー
• Meilisearch APIとのシームレスな統合
• MCPプロトコルに準拠したインターフェース
• 検索、インデックス管理、ドキュメント操作などの主要機能をサポート

📦 インストール

前提条件

• Go 1.24以上
• 稼働中のMeilisearchインスタンス

ビルド手順

# リポジトリをクローン
git clone https://github.com/cnosuke/mcp-meilisearch.git
cd mcp-meilisearch

# 依存関係をインストール
make deps

# ビルド
make bin/mcp-meilisearch

📚 ドキュメント

設定

config.ymlファイルを使用して、Meilisearchサーバーへの接続設定を構成します。

meilisearch:
  host: http://localhost:7700 # Meilisearchサーバーのアドレス
  api_key: '' # APIキーを設定する場合

環境変数を使用して設定することもできます。

• MEILISEARCH_HOST：Meilisearchサーバーのアドレス
• MEILISEARCH_API_KEY：MeilisearchのAPIキー

サーバーの起動

./bin/mcp-meilisearch server --config config.yml

オプション：

• --no-logs：ログ出力を最小限にする（エラーのみ表示）
• --log <ファイルパス>：ログを指定のファイルに出力

Claude Desktopとの統合

Claude Desktopで使用するには、claude_desktop_config.jsonファイルにMCPサーバーのエントリを追加する必要があります。MCPはstdioを使用して通信するため、--no-logsと--logフラグを使用してログをファイルにリダイレクトする必要があります。以下は設定例です。

{
  "mcpServers": {
    "sqlite": {
      "command": "./bin/mcp-meilisearch",
      "args": ["server", "--no-logs", "--log", "path_to_log_file"],
      "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "api_key"
      }
    }
  }
}

この設定により、Meilisearch MCPサーバーがClaude Desktopに登録され、ログが正しくリダイレクトされます。

ツールの説明

ヘルスチェック

• 用途：サーバーの稼働状態を検証します。
• パラメータ：なし
• 戻り値：成功時はok、失敗時はエラーメッセージ

インデックス管理

インデックスの作成

• 用途：新しいインデックスを作成します。
• パラメータ：
  • index_name：新しいインデックスの名前
• リクエストボディ（JSON）：

{
  "name": "string", // インデックス名
  "options": { // シャード数、レプリカ数などのオプション設定 }
}

• 戻り値：新しいインデックスの情報

インデックスの削除

• 用途：指定されたインデックスを削除します。
• パラメータ：
  • index_name：削除するインデックスの名前
• リクエストボディ：なし
• 戻り値：削除成功時は内容なし、失敗時はエラーメッセージ

ドキュメント操作

ドキュメントの追加

• 用途：指定されたインデックスにドキュメントを追加または更新します。
• パラメータ：
  • index_name：インデックス名
  • document_id（オプション）：ドキュメントID、デフォルトで自動生成
• リクエストボディ（JSON）：

{
  "fields": { // ドキュメントのフィールド内容 }
}

• 戻り値：挿入または更新されたドキュメントの情報

ドキュメントの一括追加

• 用途：指定されたインデックスに複数のドキュメントを一括で追加または更新します。
• パラメータ：
  • index_name：インデックス名
• リクエストボディ（JSON）：

[
  {
    "id": "string", // ドキュメントID
    "fields": { // ドキュメントのフィールド内容 }
  },
  ...
]

• 戻り値：一括操作の結果、成功と失敗したドキュメントの情報を含む

コントリビューションガイド

コードの提出

1. 機能ブランチを作成します。
2. 変更をコミットし、コミットメッセージを記述します。
3. メインブランチに提出するか、レビュー待ちとしてマークします。

コミット規則

以下の規則に従ってください。

• 各コミットは独立した機能または修正に対応している必要があります。
• コミットメッセージは簡潔で、変更内容を反映している必要があります。
• コードはすべてのテストケースを通過する必要があります。

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。

詳細情報については、プロジェクトのURLをご覧ください：https://github.com/cnosuke/mcp-meilisearch