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

此項目提供了一個基於 Python 實現的 MCP 服務器，能夠藉助 Search Labs 博客文章在 Elasticsearch 中開展語義搜索，助力用戶更高效地獲取相關信息。

🚀 快速開始

運行 MCP 服務器

將 ES_URL 和 ES_AP_KEY 添加到 .env 文件中（可參考這裡生成具有最小權限的 API 鍵）。在 MCP 監控器 中啟動服務器：

make dev

運行後，訪問 MCP 監控器：http://localhost:5173

與 Claude 桌面集成

要將 MCP 服務器添加到 Claude Desktop，執行以下命令：

make install-claude-config

這會更新位於主目錄中的 claude_desktop_config.json 文件。下次重新啟動時，Claude 應用程序會自動檢測並連接到該配置。

爬取 Search Labs 博客文章

1. 驗證爬蟲設置

確保已安裝所有必要的依賴項，並且環境變量正確配置。運行以下命令以驗證爬蟲是否正常工作：

python crawler.py --test

2. 配置 Elasticsearch

在 elasticsearch.yml 文件中，更新以下配置以優化性能和索引管理：

# Elasticsearch 配置
cluster.name: "search-labs-cluster"
node.name: "crawler-node"
path.data: /var/lib/elasticsearch

3. 更新語義搜索的索引映射

創建一個新文件 index-mapping.json，並添加以下內容以定義字段和分析器：

{
  "mappings": {
    "properties": {
      "title": {"type": "text", "analyzer": "standard"},
      "content": {"type": "text", "analyzer": "standard"},
      "date": {"type": "date", "format": "yyyy-MM-dd"}
    }
  }
}

4. 開始爬取

運行以下命令以啟動爬蟲：

make start-crawler

要停止爬蟲，按下 Ctrl+C。

5. 驗證已索引文檔

使用 Elasticsearch 查詢工具驗證索引中的數據：

curl -X GET "http://localhost:9200/search-labs-posts/_search?pretty"

✨ 主要特性

語義搜索：藉助 Search Labs 博客文章在 Elasticsearch 中實現語義搜索，提升搜索的準確性和相關性。
與 Claude 集成：可與 Claude Desktop 集成，方便在 Claude 中使用 MCP 服務器的搜索功能。
可擴展性：提供了爬取博客文章的功能，並且可以根據需要更新爬蟲規則以適應頁面結構變化。

📚 詳細文檔

概述

此倉庫提供了一個 Python 實現的 MCP 服務器，用於通過 Search Labs 博客文章 在 Elasticsearch 中進行 語義搜索。它假設您已經爬取了博客文章並將它們存儲在使用 Elastic Open Crawler 創建的 search-labs-posts 索引中。