Smart Search MCP

🚀 Smart Search MCP - 強大的智能搜索工具集

Smart Search MCP 是一款強大的智能搜索工具集，提供 14 個增強型智能搜索工具，涵蓋國際和國內多個主流平臺，能幫助用戶快速、精準地找到所需信息。

🚀 快速開始

⚠️ 從舊版本升級？

如果你之前安裝過 ai-rule-mcp-server，可使用一鍵遷移腳本：

# 🔄 一鍵遷移（自動卸載舊版本並安裝新版本）
curl -sSL https://raw.githubusercontent.com/adminhuan/smart-search-mcp/main/migrate.sh | bash

# 或手動遷移：
# 1. 卸載舊版本
npm uninstall -g ai-rule-mcp-server

# 2. 刪除舊的MCP配置
# 編輯 ~/.claude.json 刪除 "ai-rule-mcp-server" 配置

# 3. 安裝新版本（見下方）

⚡ 一鍵安裝 (推薦)

# 🎯 Claude MCP命令 (最簡單)
claude mcp add smart-search-mcp npx smart-search-mcp

# 📜 或一鍵腳本安裝
curl -sSL https://raw.githubusercontent.com/adminhuan/smart-search-mcp/main/install.sh | bash

# 📦 或NPM直接運行
npx smart-search-mcp@latest

# 🔧 或全局安裝
npm install -g smart-search-mcp

# 📥 或從GitHub源碼安裝
git clone https://github.com/adminhuan/smart-search-mcp.git
cd smart-search-mcp
npm install
npm start

🔧 配置Claude Code

在Claude Code的MCP配置中添加：

{
  "mcpServers": {
    "smart-search-mcp": {
      "command": "npx",
      "args": ["smart-search-mcp@latest"]
    }
  }
}

🎉 開始使用

安裝完成後，重啟Claude Code即可使用 14 個搜索工具：

🌍 國際平臺搜索（6 個）：

• 網絡搜索: ai_search_web() - 多引擎網絡搜索（百度/Google/Bing/搜狗）
• GitHub搜索: ai_search_github() - 搜索GitHub倉庫、代碼、Issues
• StackOverflow搜索: ai_search_stackoverflow() - 搜索技術問答
• NPM包搜索: ai_search_npm() - 搜索NPM包和文檔
• 技術文檔搜索: ai_search_docs() - 搜索框架官方文檔
• API參考搜索: ai_search_api_reference() - 查找API使用文檔

🇨🇳 國內平臺搜索（8 個）：

• 微信開發者文檔: ai_search_wechat_docs() - 搜索小程序/公眾號文檔
• CSDN搜索: ai_search_csdn() - 搜索CSDN博客和問答
• 掘金搜索: ai_search_juejin() - 搜索掘金技術文章
• SegmentFault搜索: ai_search_segmentfault() - 搜索技術問答
• 博客園搜索: ai_search_cnblogs() - 搜索博客園文章
• 開源中國搜索: ai_search_oschina() - 搜索開源項目和資訊
• 阿里雲文檔: ai_search_aliyun_docs() - 搜索阿里雲文檔
• 騰訊雲文檔: ai_search_tencent_docs() - 搜索騰訊雲文檔

✨ 主要特性

🌍 國際平臺搜索（6 個）

• ✅ 網絡搜索 - 支持 4 大搜索引擎，智能搜索技巧，相關搜索建議
• ✅ GitHub搜索 - 多維度篩選，高級搜索語法，熱門倉庫推薦
• ✅ StackOverflow - 技術問答，標籤篩選，投票排序
• ✅ NPM包搜索 - 雙重搜索方式，包詳情直達，分類推薦
• ✅ 技術文檔 - 7 大框架文檔，中文優先，快速導航
• ✅ API參考 - 多源搜索，常用庫快速訪問，代碼示例

🇨🇳 國內平臺搜索（8 個）

• ✅ 微信文檔 - 小程序/公眾號/支付，常用API速查
• ✅ CSDN - IT社區，博客/問答/資源
• ✅ 掘金 - 技術分享，前後端全棧
• ✅ SegmentFault - 技術問答，活躍社區
• ✅ 博客園 - 開發者家園，技術博客
• ✅ 開源中國 - 開源項目，技術資訊
• ✅ 阿里雲 - 雲服務文檔，產品指南
• ✅ 騰訊雲 - 雲產品文檔，API手冊

⚡ 增強功能

每個搜索工具都經過精心優化，提供：

1. 智能URL生成 - 根據不同平臺特性生成最優搜索URL
2. 輸入驗證 - 自動檢查並驗證搜索關鍵詞
3. 高級搜索技巧 - 為每個平臺提供專業的搜索語法提示
4. 相關搜索建議 - 智能推薦相關搜索詞
5. 多源搜索 - 部分工具支持多個搜索源（如NPM、API參考）
6. 平臺介紹 - 詳細的平臺說明和熱門主題推薦
7. 快速導航 - 直達官方文檔和常用資源
8. 格式化輸出 - 清晰的Markdown格式，易讀易用
9. 🆕 自動文件保存 - 搜索詳情自動保存到 .search-results/ 文件夾，界面只顯示簡潔摘要

🔍 搜索工作流程

用戶輸入搜索關鍵詞
    ↓
Smart Search MCP 處理請求
    ↓
生成優化的搜索URL + 詳細信息保存到文件
    ↓
返回簡潔摘要（關鍵詞、鏈接、文件路徑）
    ↓
Claude Code 使用 WebFetch 獲取即時結果
    ↓
用戶查看搜索結果 + 可查閱保存的詳細信息

📦 安裝指南

⚠️ 從舊版本升級？

如果你之前安裝過 ai-rule-mcp-server，可使用一鍵遷移腳本：

# 🔄 一鍵遷移（自動卸載舊版本並安裝新版本）
curl -sSL https://raw.githubusercontent.com/adminhuan/smart-search-mcp/main/migrate.sh | bash

# 或手動遷移：
# 1. 卸載舊版本
npm uninstall -g ai-rule-mcp-server

# 2. 刪除舊的MCP配置
# 編輯 ~/.claude.json 刪除 "ai-rule-mcp-server" 配置

# 3. 安裝新版本（見下方）

⚡ 一鍵安裝 (推薦)

# 🎯 Claude MCP命令 (最簡單)
claude mcp add smart-search-mcp npx smart-search-mcp

# 📜 或一鍵腳本安裝
curl -sSL https://raw.githubusercontent.com/adminhuan/smart-search-mcp/main/install.sh | bash

# 📦 或NPM直接運行
npx smart-search-mcp@latest

# 🔧 或全局安裝
npm install -g smart-search-mcp

# 📥 或從GitHub源碼安裝
git clone https://github.com/adminhuan/smart-search-mcp.git
cd smart-search-mcp
npm install
npm start

🔧 配置Claude Code

在Claude Code的MCP配置中添加：

{
  "mcpServers": {
    "smart-search-mcp": {
      "command": "npx",
      "args": ["smart-search-mcp@latest"]
    }
  }
}

💻 使用示例

搜索React Hooks最佳實踐

輸入：

ai_search_web({ query: "React Hooks 最佳實踐", engine: "baidu" })

輸出：

• 優化的搜索URL
• 4種搜索引擎選項
• 高級搜索技巧（精確匹配、排除關鍵詞、限定站點等）
• 相關搜索建議
• WebFetch使用示例

查找GitHub上的Vue3項目

輸入：

ai_search_github({ query: "vue3", type: "repositories", language: "javascript", sort: "stars" })

輸出：

• GitHub搜索鏈接
• 7種高級搜索技巧
• 相關搜索建議
• 其他搜索類型選項
• WebFetch使用示例

搜索微信小程序API

輸入：

ai_search_wechat_docs({ query: "wx.request", platform: "miniprogram" })

輸出：

• 百度站內搜索鏈接
• 微信小程序文檔直達
• 常用API快速參考
• 其他微信平臺入口
• 開發者社區鏈接

📚 詳細文檔

📖 使用方式

配置完成後，在Claude Code中可以直接使用搜索功能：

🔎 智能搜索使用

國際平臺：

1. 網絡搜索: "搜索React Hooks最佳實踐"（默認使用百度）
2. GitHub搜索: "在GitHub上搜索Vue3相關的倉庫"
3. 技術問答: "在StackOverflow上搜索如何解決CORS錯誤"
4. 包管理: "搜索NPM上的日期處理庫"
5. 文檔查詢: "搜索React官方文檔中關於useEffect的說明"
6. API參考: "查找axios的請求配置API文檔"

國內平臺： 7. 微信文檔: "搜索微信小程序一鍵登錄功能" 8. CSDN: "在CSDN上搜索HBuilder開發教程" 9. 掘金: "在掘金上搜索Vue3組合式API最佳實踐" 10. SegmentFault: "在SegmentFault上搜索React性能優化" 11. 博客園: "在博客園搜索.NET Core教程" 12. 開源中國: "搜索開源中國的前端開源項目" 13. 阿里雲: "搜索阿里雲OSS對象存儲文檔" 14. 騰訊雲: "搜索騰訊雲COS使用指南"

Claude Code會自動使用相應的MCP搜索工具，並通過WebFetch獲取真實的搜索結果。

🛠️ 管理命令

# 查看版本
npm list -g smart-search-mcp

# 更新到最新版本
npm update -g smart-search-mcp

# 卸載
npm uninstall -g smart-search-mcp

🔧 技術細節

🎯 設計特點

• 🔎 專注搜索 - 14個精心打造的搜索工具，專注做好一件事
• ⚡ 智能增強 - 每個工具都配備高級搜索技巧和智能建議
• 🌏 國內優化 - 8個國內主流技術平臺，默認百度搜索，訪問速度快
• 🌍 國際全面 - 6個國際頂級平臺，覆蓋GitHub、StackOverflow、NPM等
• ✅ 真實結果 - 配合WebFetch工具獲取真實搜索結果，非模擬數據
• 📚 多源搜索 - NPM、API參考等支持多個搜索源，提高查找成功率
• 🎨 格式優美 - Markdown格式輸出，信息層次分明，易於閱讀
• 🚀 開箱即用 - 無需數據庫，無複雜配置，一鍵安裝即可使用

📊 版本對比

v2.0.0 刪除的功能：

• ❌ 編碼規範提醒工具（用戶只需要搜索功能）

🛠️ 可用工具

📄 許可證

MIT License - 詳見 LICENSE 文件