Typesense MCP サーバー

AIモデルにTypesenseの検索機能へのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー実装。このサーバーにより、LLMはTypesenseコレクションに保存されたデータを検出、検索、分析できるようになります。

デモ

Related MCP server: All-Search MCP Server

特徴

リソース

• typesense:// URI 経由でコレクションの一覧を表示およびアクセスする

• 各コレクションには名前、説明、ドキュメント数があります

• スキーマアクセス用の JSON MIME タイプ

ツール

• タイプセンスクエリ

  • 強力なフィルタリング機能を使用してTypesenseコレクション内のドキュメントを検索します

  • 入力: クエリテキスト、コレクション名、検索フィールド、フィルター、並べ替えオプション、制限

  • 関連性スコアで一致するドキュメントを返します

• タイプセンス_get_document

  • コレクションからIDで特定のドキュメントを取得する

  • 入力: コレクション名、ドキュメントID

  • 完全なドキュメントデータを返します

• タイプセンスコレクション統計

  • Typesenseコレクションに関する統計情報を取得する

  • 入力: コレクション名

  • コレクションのメタデータ、ドキュメント数、スキーマ情報を返します

プロンプト

• 分析コレクション

  • コレクションの構造と内容を分析する

  • 入力: コレクション名

  • 出力: スキーマ、データ型、統計に関する洞察

• 検索候補

  • コレクションの効果的な検索クエリの提案を取得する

  • 入力: コレクション名

  • 出力: コレクションスキーマに基づく推奨検索戦略

インストール

npm経由

# Global installation
npm install -g typesense-mcp-server

# Local installation
npm install typesense-mcp-server

mcp-get経由

npx @michaellatman/mcp-get@latest install typesense-mcp-server

発達

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

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

開発のためのインストール

Claudeデスクトップの使用

Claude Desktop で使用するには、サーバー設定を追加します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "typesense": {
      "command": "node",
      "args": [
        "~/typesense-mcp-server/dist/index.js",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    },
  }
}

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

コンポーネント

リソース

サーバーは Typesense コレクションに関する情報を提供します。

• コレクションスキーマ( typesense://collections/<collection> )

  • 各コレクションのJSONスキーマ情報

  • フィールド名とデータ型が含まれます

  • データ構造を理解するためのサンプルドキュメント

リソーステンプレート

サーバーは次のテンプレートを提供します:

• typesense_search - Typesense検索クエリを構築するためのテンプレート

• typesense_collection - Typesenseコレクションの詳細を表示するためのテンプレート

Claude Desktopでの使用

このサーバーを Claude Desktop アプリで使用するには、 claude_desktop_config.jsonの「mcpServers」セクションに次の構成を追加します。

{
  "mcpServers": {
    "typesense": {
      "command": "npx",
      "args": [
        "-y",
        "typesense-mcp-server",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    }
  }
}

ログ記録

サーバーは次の場所にあるファイルに情報を記録します。

/tmp/typesense-mcp.log

このログには、サーバーの操作、要求、発生したエラーに関する詳細情報が含まれます。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。