Meilisearch MCP Server

Meilisearch MCP サーバー

Meilisearch 用のモデル コンテキスト プロトコル (MCP) サーバー実装。これにより、AI アシスタントは標準化されたインターフェースを通じて Meilisearch と対話できるようになります。

特徴

• インデックス管理: インデックスの作成、更新、削除
• ドキュメント管理: ドキュメントの追加、更新、削除
• 検索機能: さまざまなパラメータとフィルターを使用して検索を実行します
• 設定管理: インデックス設定を構成する
• タスク管理: 非同期タスクの監視と管理
• システム操作: ヘルスチェック、バージョン情報、統計
• ベクター検索: 実験的なベクター検索機能

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Meilisearch MCP Server を自動的にインストールするには:

手動インストール

1. リポジトリをクローンします。
   git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp
2. 依存関係をインストールします:
   npm install
3. 例に基づいて.envファイルを作成します。
   cp .env.example .env
4. .envファイルを編集して、Meilisearch 接続を構成します。

Dockerのセットアップ

Meilisearch MCP サーバーは、展開と分離を容易にするために Docker コンテナー内で実行できます。

Docker Composeの使用

Docker を使い始める最も簡単な方法は、Docker Compose を使用することです。

Dockerイメージを手動で構築して実行する

Docker イメージを手動でビルドして実行することもできます。

開発セットアップ

Meilisearch MCP サーバーに貢献したい開発者向けに、便利なセットアップ スクリプトを提供しています。

セットアップ スクリプトは次の処理を実行します。

1. .env.exampleが存在しない場合は、そこから.envファイルを作成します。
2. 依存関係をインストールする
3. プロジェクトを構築する
4. すべてが正しく動作していることを確認するためにテストを実行します

セットアップ スクリプトを実行した後、開発モードでサーバーを起動できます。

使用法

プロジェクトの構築

サーバーの実行

開発モード

クロードデスクトップ統合

Meilisearch MCP サーバーは Claude for Desktop と統合できるため、Claude を介して Meilisearch インスタンスと直接対話できます。

自動セットアップ

Claude for Desktop が Meilisearch MCP Server と連携できるように自動的に構成するセットアップ スクリプトを提供しています。

スクリプトは次のようになります。

1. オペレーティングシステムを検出し、Claude for Desktop 構成ファイルを見つけます
2. .envファイルからMeilisearchの設定を読み取ります
3. Claude for Desktop に必要な構成を生成します
4. Claude for Desktop の設定を更新するための手順を説明します

手動設定

Claude for Desktop を手動で構成する場合:

1. Claude for Desktop の構成ファイルを見つけます。
   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : %APPDATA%\Claude\claude_desktop_config.json
   • Linux : ~/.config/Claude/claude_desktop_config.json
2. 次の構成を追加します (必要に応じてパスを調整します)。

3. 変更を適用するには、Claude for Desktop を再起動します。
4. Claude で、「Meilisearch MCP サーバーを使用したい」と入力して統合を有効にします。

カーソル統合

Meilisearch MCP Server は、AI 搭載コード エディターのCursorと統合することもできます。

カーソルでMCPを設定する

1. Meilisearch MCP サーバーをインストールしてセットアップします。
   git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp npm install npm run build
2. MCP サーバーを起動します。
   npm start
3. カーソルでコマンド パレット (Cmd/Ctrl+Shift+P) を開き、「MCP: MCP サーバーに接続」を検索します。
4. 「ローカル MCP サーバーに接続する」を選択し、次の詳細を入力します。
   • 名前：メイリサーチ
   • コマンド: ノード
   • 引数: /absolute/path/to/meilisearch-ts-mcp/dist/index.js
   • 環境変数:
     MEILISEARCH_HOST=http://localhost:7700 MEILISEARCH_API_KEY=your-api-key
5. 「接続」をクリックして接続を確立します。
6. 「Meilisearch インデックスで...に関するドキュメントを検索」などのコマンドを入力することで、カーソルを介して Meilisearch インスタンスを操作できるようになりました。

利用可能なツール

Meilisearch MCP サーバーは次のツールを提供します。

インデックスツール

• create-index : 新しいインデックスを作成する
• get-index : インデックスに関する情報を取得する
• list-indexes : すべてのインデックスを一覧表示する
• update-index : インデックスを更新する
• delete-index : インデックスを削除する

ドキュメントツール

• add-documents : インデックスにドキュメントを追加する
• get-document : IDでドキュメントを取得する
• get-documents : 複数のドキュメントを取得する
• update-documents : ドキュメントを更新する
• delete-document : IDでドキュメントを削除する
• delete-documents : 複数のドキュメントを削除する
• delete-all-documents : インデックス内のすべてのドキュメントを削除する

検索ツール

• search : 文書を検索する
• multi-search : 1回のリクエストで複数の検索を実行する

設定ツール

• get-settings : インデックス設定を取得する
• update-settings : インデックス設定を更新する
• reset-settings : インデックス設定をデフォルトにリセットします
• さまざまな特定の設定ツール（同義語、ストップワード、ランキングルールなど）

タスクツール

• list-tasks : オプションのフィルタリングを使用してタスクを一覧表示する
• get-task : 特定のタスクに関する情報を取得する
• cancel-tasks : 指定されたフィルターに基づいてタスクをキャンセルします
• wait-for-task : 特定のタスクが完了するまで待機します

システムツール

• health : Meilisearch サーバーのヘルスステータスを確認する
• version : バージョン情報を取得する
• info : システム情報を取得する
• stats : インデックスに関する統計情報を取得する

ベクターツール（実験的）

• enable-vector-search : ベクトル検索を有効にする
• get-experimental-features : 実験的な機能のステータスを取得する
• update-embedders : 埋め込み側を設定する
• get-embedders : 埋め込み設定を取得する
• reset-embedders : 埋め込み設定をリセットする
• vector-search : ベクトル検索を実行する

ライセンス

マサチューセッツ工科大学