Meilisearch MCP

🚀 Meilisearch MCP サーバー

Meilisearch MCP サーバーは、Model Context Protocol (MCP) に基づくツールです。効率的で柔軟な検索とインデックス機能を提供することを目的としています。このドキュメントでは、そのインストール、設定、使用方法、および関連機能について詳しく説明します。

🚀 クイックスタート

このセクションでは、Meilisearch MCP サーバーのクイックスタートについて説明します。

📦 インストール

環境変数

サーバーを実行する前に、以下の環境変数を設定してください。

• MEILISERVER: Meilisearch サービスのアドレスを指定します。デフォルトは http://localhost:7200 です。
• MCP_API_KEY: MCP インターフェースの認証キーです。

動的接続設定

接続パラメータ（プロキシや SSL 検証など）を動的に調整することができます。以下のコマンドを使用して、設定を確認または変更できます。

# 現在の設定を確認
curl http://localhost:7200/config

# 設定を変更
curl --data '{"tls_skip_verify":true}' http://localhost:7200/config

検索機能

様々な検索モード（完全一致検索や曖昧検索など）がサポートされています。例えば：

# 完全一致クエリ
curl --user_key your_api_key --get 'http://localhost:7200/indexes/your_index_name/search?q=your_query'

# 曖昧クエリ
curl --user_key your_api_key --data '{"q":"search term","page":1}' http://localhost:7200/indexes/your_index_name/search

サーバーの起動

Meilisearch MCP サーバーを起動するには、以下のコマンドを実行します。

python -m src.meilisearch_mcp

💻 使用例

与Claude Desktop集成

claude_desktop_config.json に以下の内容を追加することで、MCP サーバーを統合できます。

{
  "mcp_server": {
    "url": "http://localhost:7200",
    "api_key": "your_api_key"
  }
}

测试工具

Node.js ツールを使用して Inspector を起動するには、以下のコマンドを実行します。

npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

✨ 主な機能

接続管理

• get-connection-settings: 現在の接続設定を取得します。
• update-connection-settings: 接続パラメータを更新します。

インデックス管理

• create-index: 新しいインデックスを作成します。
• delete-index: 指定されたインデックスを削除します。
• list-indexes: すべてのインデックスを表示します。

ドキュメント操作

• add-document: ドキュメントを追加します。
• get-document: 単一のドキュメントを取得します。
• update-document: ドキュメントを更新します。
• delete-document: ドキュメントを削除します。

設定管理

• get-settings: インデックスの設定を取得します。
• update-settings: インデックスの設定を更新します。

タスク管理

• create-task: 新しいタスクを作成します。
• get-task: タスクの状態を取得します。
• list-tasks: すべてのタスクを表示します。
• cancel-task: 未完成のタスクをキャンセルします。

システム監視

• health-check: サーバーの健全性をチェックします。
• get-stats: システムの統計情報を取得します。
• get-version: Meilisearch のバージョンを確認します。

📚 ドキュメント

贡献指南

1. プロジェクトのリポジトリをフォークします。
2. 機能ブランチを作成します。
3. コードの変更をコミットします。
4. Pull Request を送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。