Searchcraft MCPサーバー - 垂直検索管理ツールセット、自然言語指令で管理操作可能

Searchcraft MCP Server

Searchcraft MCPサーバーはSearchcraft垂直検索エンジンをベースとしたツールセットで、ドキュメント、インデックス、フェデレーション、アクセスキー、分析データを管理し、自然言語の指示で管理操作を実行することをサポートします。

検索ツール開発者ツール #検索管理 #ドキュメントインデックス #キー制御 #データ分析 .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 2

更新時間 : 2025-07-23

searchcraft-mcp-serverとは？

searchcraft-mcp-serverはSearchcraftベースのMCPサーバーで、Searchcraftクラスター内のドキュメント、インデックス、フェデレーション、アクセスキー、分析を管理するツールセットを提供します。MCPクライアント（Claude Desktopなど）が自然言語の指示で管理操作を実行できるようにします。

searchcraft-mcp-serverを使用する方法は？

searchcraft-mcp-serverを使用するには、サーバーをローカルで実行し、Claude DesktopなどのMCPクライアントに接続する必要があります。環境変数を設定してサーバーを起動することで、インデックス管理、ドキュメント操作、アクセスキー制御などの機能を利用できます。

適用シーン

このサーバーは、Searchcraftクラスターを管理する必要のある開発者、データエンジニア、システム管理者に適しています。検索インデックスの設定、ドキュメントの追加、分析の確認、ドキュメントの削除、アクセスキーの管理などのタスクに使用できます。

主要機能

インデックス管理インデックスの作成、削除、更新、クエリをサポートし、インデックスパターンと統計情報の取得も可能です。

ドキュメント管理ドキュメントの追加、削除、クエリ、更新ができ、IDまたはフィールドでのドキュメント削除もサポートします。

フェデレーション管理フェデレーションの作成、更新、削除機能を提供し、フェデレーションの詳細情報と統計情報の表示もサポートします。

認証とキー管理アクセスキーの作成、削除、更新が可能で、組織、アプリケーション、またはフェデレーションでのキーのフィルタリングもサポートします。

ストップワードと同義語管理インデックス内のストップワードと同義語の追加、削除、表示を許可します。

検索と測定検索クエリの実行、測定変換と要約データの取得をサポートします。

利点と制限

利点

直感的なAPIインターフェースを提供し、他のアプリケーションへの統合が容易です。

複数の管理操作をサポートし、Searchcraftクラスターの保守作業を簡素化します。

Claude DesktopなどのMCPクライアントと互換性があり、ユーザー体験を向上させます。

制限

サーバーの設定と実行には一定の技術的背景が必要です。

非技術者にとって、一部のコマンドとパラメータは理解しにくい場合があります。

Searchcraftクラスターの可用性に依存しており、クラスターが利用できない場合は操作できません。

使い方

環境変数の設定

プロジェクトのルートディレクトリに.envという名前のファイルを作成し、以下の内容を記入します。

依存関係のインストール

yarnを使用してプロジェクトの依存関係をインストールします。

サーバーの構築と起動

サーバーを構築して起動します。

Claude Desktopの接続

Claude Desktopの設定ファイルにMCPサーバーの設定を追加します。

使用例

インデックスの作成新しい検索ニーズに対応するインデックスを作成し、そのスキーマを定義します。

ドキュメントの追加既存のインデックスにドキュメントのバッチを追加し、後続の検索を可能にします。

ドキュメントの削除インデックスから特定のドキュメントを削除し、古いまたは無効なデータをクリーンアップします。

よくある質問

searchcraft-mcp-serverを実行するにはどのような環境が必要ですか？

Claude Desktopがサーバーに正しく接続されていることをどのように確認できますか？

エラーが発生した場合、どのようにデバッグしますか？

🚀 searchcraft-mcp-server

Searchcraft-mcp-serverは、開発者向けの垂直検索エンジンである Searchcraft をベースにしたMCPサーバーです。このサーバーを使うことで、Searchcraftクラスターのドキュメント、インデックス、連合、アクセスキー、分析などを管理することができます。

✨ 主な機能

Searchcraft MCPサーバーは、Searchcraftクラスターの管理に必要な一連のツールを提供します。以下に、利用可能なツールの概要を示します。

インデックス管理

ツール名	説明
create_index	指定されたスキーマで新しいインデックスを作成します。既存のインデックスがある場合は空になります。
delete_index	インデックスとそのすべてのドキュメントを永久に削除します。
get_all_index_stats	すべてのインデックスのドキュメント数と統計情報を取得します。
get_index_schema	特定のインデックスのスキーマ定義を取得します。
get_index_stats	特定のインデックスの統計情報とメタデータ（ドキュメント数など）を取得します。
list_all_indexes	Searchcraftインスタンス内のすべてのインデックスのリストを取得します。
patch_index	インデックススキーマの部分的な構成変更を行います（検索フィールド、重み乗数など）。
update_index	既存のインデックスの内容全体を新しいスキーマ定義で置き換えます。

ドキュメント管理

ツール名	説明
add_documents	1つまたは複数のドキュメントをインデックスに追加します。ドキュメントはJSONオブジェクトの配列として提供する必要があります。
delete_all_documents	インデックスからすべてのドキュメントを削除します。すべてのドキュメントが削除された後もインデックスは残ります。
delete_document_by_id	インデックスから内部のSearchcraft ID (_id) で単一のドキュメントを削除します。
delete_documents_by_field	フィールドの用語一致によってインデックスから1つまたは複数のドキュメントを削除します（例: {id: 'xyz'} または {title: 'foo'}）。
delete_documents_by_query	クエリ一致によってインデックスから1つまたは複数のドキュメントを削除します。
get_document_by_id	インデックスから内部のSearchcraft ID (_id) で単一のドキュメントを取得します。

連合管理

ツール名	説明
create_federation	指定された構成で連合を作成または更新します。
delete_federation	連合を永久に削除します。
get_federation_details	特定の連合の詳細情報を取得します。
get_federation_stats	連合の各インデックスのドキュメント数と合計ドキュメント数を取得します。
get_organization_federations	特定の組織のすべての連合のリストを取得します。
list_all_federations	Searchcraftインスタンス内のすべての連合のリストを取得します。
update_federation	現在の連合エンティティを更新されたもので置き換えます。

認証とキー管理

ツール名	説明
create_key	指定された権限とアクセス制御で新しい認証キーを作成します。
delete_all_keys	Searchcraftクラスター上のすべての認証キーを削除します。極めて注意して使用してください！
delete_key	特定の認証キーを永久に削除します。
get_application_keys	特定のアプリケーションに関連付けられたすべての認証キーのリストを取得します。
get_federation_keys	特定の連合に関連付けられたすべての認証キーのリストを取得します。
get_key_details	特定の認証キーの詳細情報を取得します。
get_organization_keys	特定の組織に関連付けられたすべての認証キーのリストを取得します。
list_all_keys	Searchcraftクラスター上のすべての認証キーのリストを取得します。
update_key	既存の認証キーを新しい構成で更新します。

ストップワード管理

ツール名	説明
add_stopwords	インデックスにカスタムストップワードを追加します。これらはデフォルトの言語固有の辞書に追加されます。
delete_all_stopwords	インデックスからすべてのカスタムストップワードを削除します。これはカスタムストップワードのみに影響し、デフォルトの言語辞書には影響しません。
delete_stopwords	インデックスから特定のカスタムストップワードを削除します。これはカスタムストップワードのみに影響し、デフォルトの言語辞書には影響しません。
get_index_stopwords	インデックスのすべてのストップワードを取得します。デフォルトの言語辞書とカスタムストップワードの両方が含まれます。

同義語管理

ツール名	説明
add_synonyms	インデックスに同義語を追加します。同義語はファジークエリでのみ機能し、完全一致クエリでは機能しません。
delete_all_synonyms	インデックスからすべての同義語を削除します。
delete_synonyms	インデックスから特定の同義語をそのキーで削除します。
get_index_synonyms	インデックスに定義されたすべての同義語を取得します。

検索と測定

ツール名	説明
get_measure_conversion	オプションのフィルタリングと集計パラメータを使用して測定変換データを取得します。
get_measure_summary	オプションのフィルタリングと集計パラメータを使用して測定概要データを取得します。
get_search_results	Searchcraft APIを使用して検索クエリを実行します。ファジー/完全一致、ファセット、日付範囲のサポートがあります。
get_searchcraft_status	Searchcraft検索サービスの現在の状態を取得します。

📦 インストール

環境変数

プロジェクトのルートに .env ファイルを作成し、以下の値を入力します。

# Server Config
USER_AGENT=searchcraft-mcp-server/<project-version>
DEBUG=true
PORT=3100

# Searchcraft Config
ENDPOINT_URL= # あなたのSearchcraftクラスターのエンドポイントURL
ADMIN_KEY= # あなたのSearchcraftクラスターの管理者キー（スーパーユーザーキー）

.envサンプル

サーバーの実行

環境で正しいバージョンのNodeが選択されていることを確認します。

nvm use

yarnを使用して依存関係をインストールします。

yarn

サーバーをビルドして起動します。

yarn build
yarn start

💻 使用例

Claude Desktopとの連携

Claude Desktopが searchcraft-mcp-server のツールを検出するには、サーバーが実行中である必要があります。

searchcraft-mcp-server は StreamableHTTPServerTransport を使用しているため、Claude Desktopに接続するには mcp-remote ↗︎ を使用します。

Claude Desktopの設定ファイルに以下を追加します。

claude_desktop_config.json

{
  "mcpServers": {
    "searchcraft": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:<MY-PORT-FROM-ENV>/mcp"
      ]
    }
  }
}

Claude Desktopの設定ファイルは /Users/[My Workspace]]/Library/Application Support/Claude/claude_desktop_config.json にあります。ここにファイルが存在しない場合は作成できます。

Claude Desktop設定例

Claude DesktopのNodeバージョン

Claude DesktopがMCPサーバーに接続するコマンドを実行するとき、古いバージョンのNodeを選択することがあります。システムに古いバージョンのNodeがインストールされていると、問題が発生する可能性があります。システムのデフォルトのNodeバージョンがサーバーを適切に実行できるほど高いことを確認してください。