Typesense MCPサーバー

Typesenseと連携するModel Context Protocol (MCP) サーバーです。

インストール

Smithery経由でのインストール

Smitheryを使用して、Claude Desktop用のTypesenseサーバー統合を自動的にインストールするには：

npx -y @smithery/cli install @avarant/typesense-mcp-server --client claude

手動インストール

uvをインストールします。

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

brew install uv

パッケージをクローンします。

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

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": ""
      }
    }
  }
}

Related MCP server: Better Qdrant MCP Server

トランスポート

このサーバーは2つのMCPトランスポートをサポートしています。STDIOがデフォルトであり、ほとんどのデスクトップクライアント（Claude Desktop、Cursorなど）で使用されます。リモートクライアント、Web UI、またはllama.cppチャットのようなステートレスなツールの場合は、HTTP SSEリスナーとして実行できます。

STDIO (デフォルト)

TYPESENSE_API_KEY=xyz uv run python main.py

HTTP / SSE

MCP_TRANSPORT=sseを設定（または--sseを渡す）し、必要に応じてホスト/ポートを上書きします。

TYPESENSE_API_KEY=xyz \
MCP_TRANSPORT=sse \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
uv run python main.py

サーバーは以下を公開します。

• GET http://<host>:<port>/sse — SSEイベントストリーム（クライアントはここに接続します）

• POST http://<host>:<port>/messages/ — JSON-RPCメッセージエンドポイント

利用可能なツール

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

サーバー管理

• 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 - 特定のコレクションに対してベクトル類似性検索を実行します