mcp-meilisearch

MCP Meilisearch API サーバー

StreamableHTTPトランスポートを用いてAIモデルとMeilisearch検索エンジン間の橋渡しを行う、モデルコンテキストプロトコル（MCP）サーバー実装。このプロジェクトにより、Meilisearchの強力な検索機能をAIワークフローにシームレスに統合することが可能になります。

更新された概要

このプロジェクトは、AIモデルがMeilisearchの機能と直接連携できるようにするMCPサーバーを提供します。アーキテクチャには以下が含まれます。

• MCP サーバー: モデル コンテキスト プロトコルを使用するツールとして Meilisearch API を公開します。
• Web クライアント デモ: 検索機能を紹介するデモ インターフェイス。

主な特徴

• StreamableHTTP トランスポート: クライアントとサーバー間のリアルタイム通信。
• Meilisearch API サポート: Meilisearch 機能へのフルアクセス。
• 強化されたエラー処理: API リクエストのエラー管理が改善されました。
• Web クライアント デモ: 検索機能をデモするためのインターフェイスが更新されました。

ツールカテゴリ

MCP サーバーは、Meilisearch API を次のカテゴリに分類します。

1. システム ツール: ヘルス チェック、バージョン情報、サーバー統計。
2. インデックス ツール: インデックスを管理します (作成、更新、削除、一覧表示)。
3. ドキュメント ツール: ドキュメントを追加、更新、削除、取得します。
4. 検索ツール: ベクター検索を含む高度な検索。
5. 設定ツール: インデックス設定を構成します。
6. タスク ツール: 非同期タスクを管理します。
7. ベクター ツール: 実験的なベクター検索機能。

はじめる

前提条件

• Node.js v20 以上。
• 実行中の Meilisearch インスタンス (ローカルまたはリモート)。
• Meilisearch の API キー (必要な場合)。

セットアップ手順

1. リポジトリをクローンします。

2. 依存関係をインストールします:

3. 環境を構成します。

次の内容の.envファイルを作成します。

サーバーの実行

サーバーを起動するには:

Webインターフェースへのアクセス

ブラウザで次の URL にアクセスします。

発達

このプロジェクトでは以下を使用します:

• TypeScript : 型の安全性を保証します。
• Express : Web サーバーを強化します。
• モデル コンテキスト プロトコル SDK : AI 統合を容易にします。

オプション

Meilisearch 接続オプション

• meilisearchHost : MeilisearchインスタンスのURL（デフォルト: " http://localhost:7700 "）
• meilisearchApiKey : Meilisearch で認証するための API キー (デフォルト: "")

MCP サーバー オプション

• transport : MCPサーバーのトランスポートタイプ（"http" | "stdio"）（デフォルト: "http"）
• httpPort : MCP サーバーの HTTP ポート (デフォルト: 8080)
• mcpEndpoint : MCPエンドポイントパス（デフォルト: "/mcp"）

セッションオプション

• sessionTimeout : セッションタイムアウト（ミリ秒）（デフォルト: 3600000）
• sessionCleanupInterval : セッションクリーンアップ間隔（ミリ秒）（デフォルト: 60000）

MCPClientの使用

このパッケージは、クライアント側の統合用に MCPClient クラスもエクスポートします。