Jedrazb Elastic Semantic Search MCP Server

🚀 MCP 服務器：Elasticsearch 語義搜索工具

此存儲庫提供的 MCP 服務器，基於 Python 實現，可藉助 Search Labs 博客文章在 Elasticsearch 上開展語義搜索。它能幫助用戶更高效地在海量博客文章中找到所需信息，提升搜索體驗。

🚀 快速開始

運行 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