🔍 MCP-WebSearch

為 AI Agent 提供強大的網頁搜尋 MCP 工具
整合多種搜尋引擎，支援內容爬取與即時搜尋

✨ 特色功能

🌐 多重搜尋引擎整合

• SearXNG: 聚合多種搜尋引擎 (Google, Bing, Yahoo, DuckDuckGo...)
• FireCrawl: 強大的網頁內容爬取與搜尋功能

🚀 主要功能

• 📰 網頁搜尋: 快速搜尋網路資訊
• 📋 新聞搜尋: 獲取最新新聞資訊
• 🔬 學術搜尋: 搜尋科學文獻與研究
• 📱 社交媒體: 搜尋社交平台內容
• 📄 內容提取: 將網頁內容轉換為 Markdown 格式

🚀 快速開始

1. 克隆專案

git clone https://github.com/TsukiSama9292/MCP-WebSearch.git
cp .env.local .env
cd MCP-WebSearch

2. 啟動服務

docker compose up -d

⚙️ 環境配置

必要環境變數

變數名稱	描述	預設值	範例
SEARXNG_HOST	SearXNG 服務主機位址	http://localhost	http://192.168.1.100
SEARXNG_PORT	SearXNG 服務端口	8080	8080
FIRECRAWL_CLOUD	是否使用 FireCrawl 雲端服務	false	true/false
FIRECRAWL_HOST	FireCrawl 服務主機位址	http://localhost	http://192.168.1.100
FIRECRAWL_PORT	FireCrawl 服務端口	3002	3002
FIRECRAWL_API_KEY	FireCrawl API 金鑰	firecrawl_api_key	your_api_key_here

配置範例

# SearXNG 配置
SEARXNG_HOST=http://192.168.200.102
SEARXNG_PORT=8080

# FireCrawl 配置
FIRECRAWL_CLOUD=false
FIRECRAWL_HOST=http://192.168.200.102
FIRECRAWL_PORT=3002
FIRECRAWL_API_KEY=your_firecrawl_api_key

🛠️ 本地開發

安裝依賴

# 使用 uv (推薦)
uv sync

啟動服務

uv run python main.py

執行測試

uv run pytest -v

📁 專案結構

MCP-WebSearch/
├── 📁 src/
│   └── 📁 mcp_websearch/
│       ├── 📁 searxng/          # SearXNG 搜尋模組
│       ├── 📁 firecrawl/        # FireCrawl 搜尋模組
│       └── 📄 runner.py         # MCP 服務運行器
├── 📁 tests/                    # 測試文件
├── 📄 main.py                   # 主程式入口
├── 📄 docker-compose.yml        # Docker 配置
├── 📄 pyproject.toml            # Python 專案配置
└── 📄 README.md                 # 專案說明

---

⭐ 如果這個專案對你有幫助，請給這個專案一個星星吧！

Made with ❤️ by TsukiSama9292