Jedrazb Elastic Semantic Search MCP Server

🚀 MCP サーバー：Elasticsearch セマンティック検索ツール

このツールは、Search Labs ブログ記事を対象に、Elasticsearch 上でセマンティック検索を行うための Python 実装の MCP サーバーです。

🚀 クイックスタート

目次

• 概要
• MCP サーバーの起動
• Claude Desktop との統合
• Search Labs ブログ記事のクローリング
  • 1. クローラー設定の検証
  • 2. Elasticsearch の設定
  • 3. セマンティック検索インデックスマッピングの更新
  • 4. クローリングの開始
  • 5. インデックス化されたドキュメントの検証

概要

このリポジトリは、Python で実装された MCP サーバー を提供しており、Search Labs ブログ記事 を対象に Elasticsearch 上で セマンティック検索 を行うことができます。

このツールでは、ブログ記事をクローリングし、Elastic Open Crawler を使用して作成された search-labs-posts インデックスに保存していることを前提としています。

MCP サーバーの起動

ES_URL と ES_AP_KEY を .env ファイルに追加します（こちら を参照して、最小限の権限を持つ API キーを生成してください）。

MCP チェッカー でサーバーを起動します：

make dev

起動後、MCP チェッカーにアクセスします：http://localhost:5173

Claude Desktop との統合

MCP サーバーを Claude Desktop に追加するには、以下のコマンドを実行します：

make install-claude-config

これにより、ホームディレクトリ内の claude_desktop_config.json が更新されます。次回再起動時に、Claude アプリケーションがサーバーを検出し、宣言されたツールを読み込みます。

Search Labs ブログ記事のクローリング

1. クローラー設定の検証

Elastic Open Crawler が正常に動作していることを確認するには、以下のコマンドを実行します：

docker run --rm \
  --entrypoint /bin/bash \
  -v "$(pwd)/crawler-config:/app/config" \
  --network host \
  docker.elastic.co/integrations/crawler:latest \
  -c "bin/crawler crawl config/test-crawler.yml"

これにより、単一のページ からクローリングされた内容が出力されるはずです。

2. Elasticsearch の設定

Elasticsearch の URL と API キー を設定します。

最小限のクローラー権限 を持つ API キーを生成します：

POST /_security/api_key
{
  "name": "crawler-search-labs",
  "role_descriptors": {
    "crawler-search-labs-role": {
      "cluster": ["monitor"],
      "indices": [
        {
          "names": ["*"],
          "privileges": ["read", "write"]
        }
      ]
    }
  },
  "managed": true
}

API キーを取得するためのコマンドを実行します：

curl -X GET http://localhost:9200/_security/api_key \
  -H 'Content-Type: application/json' \
  -d '{"name":"crawler-search-labs"}'

返された api_key と id を .env ファイルに追加します：

ES_URL=http://localhost:9200
ES_AP_KEY=your_api_key_here
ES_AP_ID=your_api_id_here

3. セマンティック検索インデックスマッピングの更新

動的フィールドデータ と 自動マッピング を有効にするため、Elasticsearch インデックスマッピングを更新します：

curl -X PUT http://localhost:9200/search-labs/_mapping \
  -H 'Content-Type: application/json' \
  -d '{"dynamic": true}'

4. クローリングの開始

以下のコマンドを使用して、Search Labs ブログ記事のクローリングを開始します：

python3 crawler.py --config config/crawler_config.yml

crawler_config.yml のサンプル内容は以下の通りです：

start_url: "https://search-labs.com/blog"
output_file: "blog_posts.json"
concurrency: 5
max_depth: 2

5. インデックス化されたドキュメントの検証

ブログ記事が正しくインデックス化されていることを確認するには、以下のコマンドを実行します：

curl -X GET http://localhost:9200/search-labs/_search \
  -H 'Content-Type: application/json' \
  -d '{"query":{"match_all":{}}}'

これにより、すべてのインデックス化されたブログ記事が返されます。

完全な例

.env ファイルの作成

ES_URL=http://localhost:9200