Meilisearch MCP サーバー

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

特徴

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

インストール

Smithery経由でインストール

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

npx -y @smithery/cli install @devlimelabs/meilisearch-ts-mcp --client claude

手動インストール

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

Dockerのセットアップ

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

Docker Composeの使用

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

# Start the Meilisearch MCP Server
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the server
docker-compose down

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

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

# Build the Docker image
docker build -t meilisearch-ts-mcp .

# Run the container
docker run -p 3000:3000 --env-file .env meilisearch-ts-mcp

開発セットアップ

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

# Clone the repository
git clone https://github.com/devlimelabs-ts-mcp/meilisearch-ts-mcp.git
cd meilisearch-ts-mcp

# Run the development setup script
./scripts/setup-dev.sh

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

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

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

npm run dev

使用法

プロジェクトの構築

npm run build

サーバーの実行

npm start

開発モード

npm run dev

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

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

自動セットアップ

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

# First build the project
npm run build

# Then run the setup script
node scripts/claude-desktop-setup.js

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

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

手動設定

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

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
次の構成を追加します (必要に応じてパスを調整します)。

{
  "mcpServers": {
    "meilisearch": {
      "command": "node",
      "args": ["/path/to/meilisearch-ts-mcp/dist/index.js"],
      "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

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

カーソル統合

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

カーソルでMCPを設定する

Meilisearch MCP サーバーをインストールしてセットアップします。
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp npm install npm run build
MCP サーバーを起動します。
npm start
カーソルでコマンドパレット (Cmd/Ctrl+Shift+P) を開き、「MCP: MCP サーバーに接続」を検索します。
「ローカル MCP サーバーに接続する」を選択し、次の詳細を入力します。
- 名前：メイリサーチ
- コマンド: ノード
- 引数: /absolute/path/to/meilisearch-ts-mcp/dist/index.js
- 環境変数:
  MEILISEARCH_HOST=http://localhost:7700 MEILISEARCH_API_KEY=your-api-key
「接続」をクリックして接続を確立します。
「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 : ベクトル検索を実行する

ライセンス

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

Meilisearch MCP Server

Integrations