Typesense

🚀 タイプ感知 MCP サーバ

Typesense(https://github.com/modelcontextprotocol/python-sdk)（MCP）プロトコルインターフェースと連携する MCP サーバです。

🚀 クイックスタート

このセクションでは、タイプ感知 MCP サーバのインストールと設定方法を説明します。

📦 インストール

1. uv のインストール

uv をインストールします。Mac では homebrew を使用してインストールできます。

brew install uv

2. パッケージのクローン

git clone git@github.com:avarant/typesense-mcp-server.git ~/typesense-mcp-server

3. .cursor/mcp.json の更新

Cursor で使用するために .cursor/mcp.json を更新します。

{
  "mcpServers": {
    "typesense": {
      "command": "uv",
      "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"],
      "env": {
        "TYPESENSE_HOST": "",
        "TYPESENSE_PORT": "", 
        "TYPESENSE_PROTOCOL": "",
        "TYPESENSE_API_KEY": ""
      }
    }
  }
}

✨ 主な機能

Typesense MCP Server は以下のツールを提供します。

サーバ管理

• check_typesense_health - 設定された Typesense サーバのヘルス状態をチェックします。
• list_collections - Typesense サーバ内のすべてのコレクションのリストを取得します。

コレクション管理

• describe_collection - 特定のコレクションのスキーマとメタデータを取得します。
• export_collection - 特定のコレクション内のすべてのドキュメントをエクスポートします。
• create_collection - 提供されたスキーマを使用して新しいコレクションを作成します。
• delete_collection - 特定のコレクションを削除します。
• truncate_collection - すべてのドキュメントを削除してもスキーマを保持することで、コレクションをトランケートします。

ドキュメント操作

• create_document - 特定のコレクション内に単一の新しいドキュメントを作成します。
• upsert_document - 特定のコレクション内の単一のドキュメントをアップサート（作成または更新）します。
• index_multiple_documents - 複数のドキュメントをバッチ挿入（作成、アップサート、または更新）します。
• delete_document - 特定のコレクションから ID を基に単一のドキュメントを削除します。
• import_documents_from_csv - CSV データからコレクションにドキュメントをインポートします。

検索機能

• search - 特定のコレクションでキーワード検索を実行します。
• vector_search - 特定のコレクションでベクトル類似性検索を実行します。