Smart Search MCP

🚀 Smart Search MCP - A Powerful Intelligent Search Toolkit

🎉 Major Update in v2.0.0 - Extremely streamlined and feature-rich! Focus on 14 high-quality search tools.

Smart Search MCP offers 14 enhanced intelligent search tools:

🌍 International Platform Search (6 tools)

• ✅ Web Search - Supports 4 major search engines, provides intelligent search techniques and relevant search suggestions.
• ✅ GitHub Search - Allows multi-dimensional filtering, offers advanced search syntax, and recommends popular repositories.
• ✅ StackOverflow - Enables technical Q&A, tag filtering, and vote sorting.
• ✅ NPM Package Search - Features dual search methods, direct access to package details, and category recommendations.
• ✅ Technical Documentation - Covers documentation of 7 major frameworks, prioritizes Chinese versions, and provides quick navigation.
• ✅ API Reference - Supports multi-source search, offers quick access to common libraries, and provides code examples.

🇨🇳 Domestic Platform Search (8 tools)

• ✅ WeChat Documentation - Allows quick search of APIs for mini-programs, official accounts, and payments.
• ✅ CSDN - An IT community with blogs, Q&A, and resources.
• ✅ Juejin - A platform for technical sharing, covering full-stack development.
• ✅ SegmentFault - A technical Q&A community with high activity.
• ✅ Cnblogs - A home for developers with technical blogs.
• ✅ OSChina - Offers open-source projects and technical news.
• ✅ Alibaba Cloud - Provides cloud service documentation and product guides.
• ✅ Tencent Cloud - Offers cloud product documentation and API manuals.

🚀 Quick Start

⚠️ Upgrading from an old version?

If you previously installed ai-rule-mcp-server, use the one-click migration script:

# 🔄 One-click migration (automatically uninstall the old version and install the new one)
curl -sSL https://raw.githubusercontent.com/adminhuan/smart-search-mcp/main/migrate.sh | bash

# Or manually migrate:
# 1. Uninstall the old version
npm uninstall -g ai-rule-mcp-server

# 2. Delete the old MCP configuration
# Edit ~/.claude.json and remove the "ai-rule-mcp-server" configuration

# 3. Install the new version (see below)

⚡ One-click installation (recommended)

# 🎯 Claude MCP command (the simplest)
claude mcp add smart-search-mcp npx smart-search-mcp

# 📜 Or install via one-click script
curl -sSL https://raw.githubusercontent.com/adminhuan/smart-search-mcp/main/install.sh | bash

# 📦 Or run directly via NPM
npx smart-search-mcp@latest

# 🔧 Or install globally
npm install -g smart-search-mcp

# 📥 Or install from GitHub source code
git clone https://github.com/adminhuan/smart-search-mcp.git
cd smart-search-mcp
npm install
npm start

🔧 Configure Claude Code

Add the following to the MCP configuration in Claude Code:

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

🎉 Start using

After installation, restart Claude Code to use the 14 search tools:

🌍 International Platform Search (6 tools):

• Web Search: ai_search_web() - Multi-engine web search (Baidu/Google/Bing/Sogou).
• GitHub Search: ai_search_github() - Search GitHub repositories, code, and issues.
• StackOverflow Search: ai_search_stackoverflow() - Search technical Q&A.
• NPM Package Search: ai_search_npm() - Search NPM packages and documentation.
• Technical Documentation Search: ai_search_docs() - Search official framework documentation.
• API Reference Search: ai_search_api_reference() - Find API usage documentation.

🇨🇳 Domestic Platform Search (8 tools):

• WeChat Developer Documentation: ai_search_wechat_docs() - Search mini-program/official account documentation.
• CSDN Search: ai_search_csdn() - Search CSDN blogs and Q&A.
• Juejin Search: ai_search_juejin() - Search Juejin technical articles.
• SegmentFault Search: ai_search_segmentfault() - Search technical Q&A.
• Cnblogs Search: ai_search_cnblogs() - Search Cnblogs articles.
• OSChina Search: ai_search_oschina() - Search open-source projects and news.
• Alibaba Cloud Documentation: ai_search_aliyun_docs() - Search Alibaba Cloud documentation.
• Tencent Cloud Documentation: ai_search_tencent_docs() - Search Tencent Cloud documentation.

✨ Features

⚡ Enhanced Functions

Each search tool is carefully optimized to provide:

1. Intelligent URL Generation - Generate optimal search URLs based on different platform characteristics.
2. Input Validation - Automatically check and validate search keywords.
3. Advanced Search Techniques - Provide professional search syntax tips for each platform.
4. Related Search Suggestions - Intelligently recommend related search terms.
5. Multi-source Search - Some tools support multiple search sources (e.g., NPM, API reference).
6. Platform Introduction - Provide detailed platform descriptions and popular topic recommendations.
7. Quick Navigation - Directly access official documentation and common resources.
8. Formatted Output - Present information in clear Markdown format, easy to read and use.
9. 🆕 Automatic File Saving - Automatically save search details to the .search-results/ folder, and only display a concise summary on the interface.

🔍 Search Workflow

User inputs search keywords
    ↓
Smart Search MCP processes the request
    ↓
Generates optimized search URLs and saves detailed information to files
    ↓
Returns a concise summary (keywords, links, file paths)
    ↓
Claude Code uses WebFetch to obtain real-time search results
    ↓
User views search results and can access the saved detailed information

📊 Version Comparison

Features removed in v2.0.0:

• ❌ Coding specification reminder tool (users only need search functions)

🛠️ Available Tools

💻 Usage Examples

Search for the best practices of React Hooks

Input:

ai_search_web({ query: "Best practices for React Hooks", engine: "baidu" })

Output:

• Optimized search URL
• 4 search engine options
• Advanced search techniques (exact match, exclude keywords, limit sites, etc.)
• Related search suggestions
• WebFetch usage example

Find Vue3 projects on GitHub

Input:

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

Output:

• GitHub search link
• 7 advanced search techniques
• Related search suggestions
• Other search type options
• WebFetch usage example

Search for WeChat mini-program APIs

Input:

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

Output:

• Baidu in-site search link
• Direct access to WeChat mini-program documentation
• Quick reference to common APIs
• Other WeChat platform entrances
• Developer community link

📖 Usage

After configuration, you can directly use the search function in Claude Code:

🔎 Intelligent Search Usage

International Platforms:

1. Web Search: "Search for the best practices of React Hooks" (default using Baidu).
2. GitHub Search: "Search for Vue3-related repositories on GitHub".
3. Technical Q&A: "Search for how to solve CORS errors on StackOverflow".
4. Package Management: "Search for date processing libraries on NPM".
5. Documentation Query: "Search for the description of useEffect in the official React documentation".
6. API Reference: "Find the request configuration API documentation of axios".

Domestic Platforms: 7. WeChat Documentation: "Search for the one-click login function of WeChat mini-programs". 8. CSDN: "Search for HBuilder development tutorials on CSDN". 9. Juejin: "Search for the best practices of Vue3 Composition API on Juejin". 10. SegmentFault: "Search for React performance optimization on SegmentFault". 11. Cnblogs: "Search for.NET Core tutorials on Cnblogs". 12. OSChina: "Search for front-end open-source projects on OSChina". 13. Alibaba Cloud: "Search for Alibaba Cloud OSS object storage documentation". 14. Tencent Cloud: "Search for Tencent Cloud COS usage guides".

Claude Code will automatically use the corresponding MCP search tool and obtain real search results through WebFetch.

🛠️ Management Commands

# Check the version
npm list -g smart-search-mcp

# Update to the latest version
npm update -g smart-search-mcp

# Uninstall
npm uninstall -g smart-search-mcp

🔧 Technical Details

🎯 Design Features

• 🔎 Focus on Search - 14 carefully crafted search tools, focusing on one thing.
• ⚡ Intelligent Enhancement - Each tool is equipped with advanced search techniques and intelligent suggestions.
• 🌏 Domestic Optimization - 8 mainstream domestic technical platforms, defaulting to Baidu search for fast access.
• 🌍 International Coverage - 6 top international platforms, covering GitHub, StackOverflow, NPM, etc.
• ✅ Real Results - Obtain real search results with the WebFetch tool, not simulated data.
• 📚 Multi-source Search - NPM, API reference, etc. support multiple search sources to improve search success rate.
• 🎨 Beautiful Format - Output in Markdown format with clear information hierarchy and easy to read.
• 🚀 Ready to Use - No database required, no complex configuration, just install and use.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.