web-mcp
Web search via Brave Search API; future extension requiring API key.
Web search via DuckDuckGo HTML search, no API key required.
Web search via SearXNG meta search engine, self-hosted or local.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@web-mcp search for MCP server setup guide"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Web MCP Server
Claude Code / Codex から利用する Web 検索・Web ページ取得用の MCP サーバーです。
コマンド
開発は Windows でも行えますが、運用時は Docker 上の Ubuntu で動かす前提です。
Linux / Docker コンテナ内の想定:
npm install
npm run build
npm run devWindows 開発環境:
npm install
npm run build
npm run devDocker イメージで HTTP MCP サーバーとして起動:
docker build -t web-mcp .
docker run --rm -p 3000:3000 web-mcpDocker Compose で起動:
cd mcp
docker compose up -d --buildHTTP MCP endpoint:
http://localhost:3000/mcpstdio サーバーとして使う場合は、クライアントが node dist/index.js を起動します。
Docker で stdio として使う場合は、docker run -i --rm web-mcp node dist/index.js のように標準入力・標準出力をクライアントへ接続してください。
ビルド後、MCP クライアントからは以下のように起動できます。
{
"mcpServers": {
"web-mcp": {
"command": "node",
"args": ["/app/mcp/dist/index.js"],
"env": {
"WEB_MCP_DEFAULT_RENDER": "auto",
"WEB_MCP_FETCH_TIMEOUT_MS": "15000",
"WEB_MCP_USER_AGENT": "LocalLLM-WebMCP/0.1"
}
}
}
}Related MCP server: mcp-web-tools
提供ツール
web_search: DuckDuckGo HTML 検索で実検索し、検索結果一覧を返します。web_fetch:http/httpsURL を取得し、HTML から本文・タイトル・リンクを抽出します。web_find:web_fetch相当の取得結果から指定文字列を検索します。
検索プロバイダー方針
検索プロバイダーは無料で使えるものを優先します。
現在の実装:
DuckDuckGo HTML 検索: API キー不要で利用
将来候補:
SearxNG: 社内またはローカルで立てるメタ検索
Brave Search などの API キーが必要な provider は、無料枠が必要になった場合の拡張候補
設定
環境変数で主な既定値を変更できます。
環境変数 | 既定値 | 用途 |
|
| MCP サーバー名 |
|
|
|
|
|
|
|
| 既定の render 指定 |
|
| 静的 fetch のタイムアウト |
|
| 将来のブラウザ取得用タイムアウト |
|
| 静的 fetch で送信する User-Agent |
| 未指定 |
|
|
| HTTP MCP サーバーの bind host |
|
| HTTP MCP サーバーの port |
現在の実装範囲
実装済み:
MCP stdio server
MCP Streamable HTTP server
web_search/web_fetch/web_findの登録DuckDuckGo HTML による実検索
web_searchのtime_range/include_domains/exclude_domains対応AbortController による静的 fetch timeout
設定値からの User-Agent 送信
redirect 後の
final_url返却静的 HTML / XHTML / plain text fetch
Content-Type判定と未対応形式の error レスポンスReadability + Turndown による Markdown 風テキスト化
Readability が本文を十分に抽出できない場合の DOM fallback 抽出
max_chars/truncated対応と Markdown 破損を抑える切り詰めinclude_links指定時のリンク抽出fetch 失敗 / timeout の error レスポンス
未実装:
Playwright によるブラウザレンダリング取得
PDF テキスト抽出
取得済みページのキャッシュ
エラー形式
失敗時も MCP ツールとしては JSON を返し、error に原因を入れます。
{
"error": {
"code": "FETCH_TIMEOUT",
"message": "The operation was aborted.",
"url": "https://example.com",
"retryable": true
}
}主な code は FETCH_FAILED、FETCH_TIMEOUT、UNSUPPORTED_CONTENT_TYPE、BROWSER_RENDER_FAILED です。
PDF は現時点では UNSUPPORTED_CONTENT_TYPE として返します。
Available Tools
3 toolsweb_fetchWeb FetchC
Fetch a URL with static HTTP and return readable Markdown-style page text.
Inputs: url (required), render, max_chars, timeout_ms, +3 more.
web_findWeb FindC
Fetch a URL with static HTTP and find text within the extracted page text.
Inputs: url (required), query (required), render, timeout_ms, +2 more.
web_searchWeb SearchB
Search the web and return a list of candidate pages. This scaffold returns mock results only.
Inputs: query (required), region, language, time_range, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
web_fetch and web_find both involve fetching a URL, but one returns the full page text and the other finds specific text within it, making their purposes distinct with clear descriptions. web_search is entirely different.
All tools follow the consistent 'web_verb' pattern (fetch, find, search), indicating a predictable naming convention.
Three tools is an appropriate number for a web utility server, covering core operations without being too sparse or excessive.
The tools cover basic web tasks (fetch, find text, search) but lack advanced features like POST requests, pagination, or element extraction, which are notable gaps for a comprehensive web server.
Related MCP Connectors
Web knowledge fetching tools for your agent.
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Web search and page reading for AI agents, including JSON APIs, RSS feeds and YouTube.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables web search through DuckDuckGo and webpage content fetching with intelligent text extraction. Features built-in rate limiting and LLM-optimized result formatting for seamless integration with language models.2MIT
- AlicenseAqualityDmaintenanceProvides web access capabilities for LLMs including search, fetching, content extraction, PDF reading, image viewing, and screenshots.333 PyPI46MIT
- AlicenseNot gradedqualityFmaintenanceProvides web search and page fetching capabilities using Ollama's API.MIT
- AlicenseNot gradedqualityDmaintenanceProvides web search with content extraction, YouTube subtitles, and optional LLM summarization for AI assistants.Apache 2.0