🌐 Open-WebSearch MCP: Give Your AI Plugin Real-Time Web Access — for Free

Aasee — Thu, 10 Jul 2025 03:38:13 +0000

🌐 Open-WebSearch MCP: Give Your AI Plugin Real-Time Web Access — for Free

🧠 "Let your AI plugin really access the web — no API key, no rate limits, fully self-hosted and multi-engine."

🤔 Why I Built This

If you've ever worked with tools like Claude, LangChain, or built your own RAG pipeline, you’ve probably hit this wall:

💭 “The AI doesn’t know what's on the internet. And adding web access usually means paying for Bing or Google Search APIs.”

That didn’t sit right with me.

So I built Open-WebSearch MCP — an open-source, multi-engine web search server that speaks Claude-compatible MCP protocol.

It works with Claude Dev Plugin, Cherry Studio, LangChain MCP clients — and it doesn’t need any API key.

🔧 What It Does

✅ Multi-Engine Web Search
Supports Bing, Baidu, DuckDuckGo, CSDN, Exa, and Brave. More coming soon.
You can even combine them in a single query.

✅ Structured Output
Search results are returned as JSON:

{
  "title": "Result title",
  "url": "https://...",
  "description": "...",
  "source": "engine.com",
  "engine": "bing"
}

✅ Article Fetching
It includes tools to extract full blog content (e.g., CSDN, Linux.do).

✅ Fully Free, Self-Hosted
No Bing/Google API keys, no scraping limits (you host it), no cloud vendor lock-in.

✅ Streamable + SSE Support
Integrates with Claude, Cherry Studio, and LangChain clients out of the box using the MCP protocol with streamableHttp or SSE.

✅ Docker Ready
Run with a single command via Docker or deploy manually with Node.js.

🚀 Quickstart

Option 1: Run Locally

git clone https://github.com/Aas-ee/open-webSearch
cd open-webSearch
npm install
npm run build
node build/index.js

Option 2: Docker (recommended)

docker run -d \
  --name web-search \
  -p 3000:3000 \
  -e ENABLE_CORS=true \
  -e CORS_ORIGIN=* \
  ghcr.io/aas-ee/open-web-search:latest

You can configure:

Proxy support (USE_PROXY)
Default search engine (DEFAULT_SEARCH_ENGINE)
CORS settings, etc.

🧩 Example: Using in a Claude Plugin

You can plug it directly into Claude’s Dev Extension, Desktop client, or Cherry Studio like this:

{
  "mcpServers": {
    "web-search": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp"
    },
    "web-search-sse": {
      "type": "sse",
      "url": "http://localhost:3000/sse"
    }
  }
}

Then call the search tool like this:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "LangChain vs Claude",
    limit: 5,
    engines: ["bing", "csdn", "duckduckgo"]
  }
})

Or fetch full articles:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "fetchCsdnArticle",
  arguments: {
    url: "https://blog.csdn.net/xxx/article/details/xxx"
  }
})

🛠️ Dev-Friendly Features

☁️ Auto CI/CD build to Docker Hub & GitHub Container Registry
🧱 Easily extend search engine support (just add a new engine handler)
🔒 Runs fully offline in LAN/internal AI labs
🧪 Great for RAG, LangChain agents, or plugin testing

🔗 Links

GitHub: https://github.com/Aas-ee/open-webSearch
Docker: ghcr.io/aas-ee/open-web-search:latest

❤️ Want to Contribute?

Pull requests and issues welcome! Feel free to:

Fork it for your own plugin setup
Add new search engines or article extractors
Help improve stability (esp. HTML selectors!)

🌟 Summary

If you're building AI tools and want real-time web access — but don’t want to pay for search APIs — this project is for you.

"Open-WebSearch MCP: Let your AI agents actually browse the web — for free, forever."

Give it a ⭐ if you find it useful!

🧠 Open‑WebSearch MCP Plugin — Free multi‑engine web search 🌐, no API key!

Aasee — Thu, 03 Jul 2025 06:18:13 +0000

Hey👋, I built something I think you’ll dig:

🔗 GitHub: https://github.com/Aas-ee/open-webSearch
🐳 Docker: ghcr.io/aas-ee/open-web-search:latest

✨ What It Does

Supports Bing, Baidu, CSDN (linux.do in progress)
ZERO API keys—no quotas, no login
Returns structured JSON: {title, url, description, source, engine}
Fully MCP-compatible: streamableHttp & SSE transport styles
Built-in article scraping: fetchCsdnArticle, fetchLinuxDoArticle
One-command Docker deploy for self-hosting

🧪 Example in Action

1. Start the server

git clone https://github.com/Aas-ee/open-webSearch
cd open-webSearch
npm install && npm run build
node build/index.js

or via Docker:

docker run -d -p 3000:3000 ghcr.io/aas-ee/open-web-search:latest

2. Add to your MCP client config

Streamable HTTP version (e.g., Claude Dev / Cherry Studio):

"mcpServers": {
  "web-search": {
    "type": "streamableHttp",
    "url": "http://localhost:3000/mcp"
  }
}

SSE alternative:

"mcpServers": {
  "web-search": {
    "type": "sse",
    "url": "http://localhost:3000/sse"
  }
}

3. Use it in a tool call

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "Claude plugin tutorial",
    limit: 3,
    engines: ["bing", "csdn"]
  }
})

➡️ Returns structured results:

[
  {
    "title": "How to write a Claude plugin",
    "url": "...",
    "description": "...",
    "source": "CSDN",
    "engine": "csdn"
  }
]

And to fetch a full article:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "fetchCsdnArticle",
  arguments: {
    url: "https://blog.csdn.net/.../details/..."
  }
})

✅ Why It Matters

💸 No API keys, no costs
🔎 Multi-engine = richer, broader results
🧠 Plug-and-play for Claude, LangChain, RAG systems
🏗️ Great for real-time Q&A, smart agents, prompt-enhanced workflows

What’s Next?

Google, Reddit, YouTube engine support
Poll: which engine/source do you want next?

If you try it, I’d love feedback, issues/PRs, or just a ⭐️. Let me know how it fits in your MCP workflow! 🙏

DEV Community: Aasee

🌐 Open-WebSearch MCP: Give Your AI Plugin Real-Time Web Access — for Free

🌐 Open-WebSearch MCP: Give Your AI Plugin Real-Time Web Access — for Free

🤔 Why I Built This

🔧 What It Does

🚀 Quickstart

Option 1: Run Locally

Option 2: Docker (recommended)

🧩 Example: Using in a Claude Plugin

🛠️ Dev-Friendly Features

🔗 Links

❤️ Want to Contribute?

🌟 Summary

🧠 Open‑WebSearch MCP Plugin — Free multi‑engine web search 🌐, no API key!

✨ What It Does

🧪 Example in Action

✅ Why It Matters

What’s Next?