Skip to main content
Glama
deenesjakoruzh
chenxuyaun

free-web-mcp

by chenxuyaun
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

free_web_mcp

Free Web MCP —— 無料の MCP Server で、Claude / Cursor / その他の MCP Client にウェブ検索（DuckDuckGo、API Key 不要）とウェブページ取得 + 本文抽出ツールを提供します。

詳細な要件は docs/free_web_mcp.md を参照してください。

ツール

ツール

説明

web_search(query, max_results=5)

DuckDuckGo で検索し、{title,url,snippet,source} のリストを返します

web_fetch(url, rendered=False)

ウェブページを取得して本文を抽出し、{url,title,content,text_length} を返します。rendered=True の場合は headless Chromium を駆動します（RENDER_ENABLED=true が必要）

web_search_and_fetch(query, max_results=5, rendered=False)

検索後、上位 N 件の結果の本文を順に取得します

Related MCP server: qsearch

クイックスタート

uv sync

stdio モード（ローカルクライアント）

uv run free-web-mcp                # 或: uv run python -m free_web_mcp

Cursor / Claude Desktop の設定例：

{
  "mcpServers": {
    "free-web-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/free_web_mcp", "free-web-mcp"]
    }
  }
}

HTTP モード（リモートデプロイ）

uv run free-web-mcp --transport http   # 监听 .env 中的 HOST/PORT，默认 0.0.0.0:8000
curl http://localhost:8000/health      # -> {"status":"ok","service":"free-web-mcp"}

MCP streamable-http エンドポイント：http://<host>:8000/mcp。

Docker

# 默认：仅 HTTP 抓取路径
docker build -f docker/Dockerfile -t free-web-mcp .
docker run --rm -p 8000:8000 free-web-mcp

# 启用 headless 渲染（构建时下载 Chromium ~150MB；首次启动约 1-3s）
docker build -f docker/Dockerfile --build-arg INSTALL_PLAYWRIGHT_BROWSERS=true -t free-web-mcp:render .
docker run --rm -p 8000:8000 -e RENDER_ENABLED=true free-web-mcp:render

設定（.env）

.env.example を .env にコピーして必要に応じて変更します。.env はリポジトリにコミットしません。

変数

デフォルト

説明

HOST / PORT

0.0.0.0 / 8000

HTTP リッスンアドレス

LOG_LEVEL

INFO

ログレベル

HTTP_TIMEOUT

30

取得タイムアウト（秒）

MAX_CONTENT_LENGTH

5000000

レスポンスボディのサイズ上限（バイト）

SEARCH_MAX_RESULTS

10

max_results のハード上限

RENDER_ENABLED

false

headless ブラウザを有効にするかどうか（Playwright + Chromium）

RENDER_TIMEOUT

30

レンダリングタイムアウト（秒）

RENDER_MAX_BYTES

5000000

レンダリング後のレスポンスボディのサイズ上限

開発

uv run pytest                  # 测试
uv run ruff check .            # lint
uv run mypy                    # 类型检查（strict）

アーキテクチャ

厳密なレイヤー構造：MCP Tool 層 → Service 層（SearchService/FetchService）→ Provider/HTTP 層。検索ソースはプラグイン可能（現在の実装：DuckDuckGoProvider）、HTTP は一律 WebClient を使用し、本文抽出は trafilatura を優先、BeautifulSoup をフォールバックとします。詳細は AGENTS.md を参照してください。

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • qsearch

    theYahia
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.
    3
    2
    Apache 2.0

  • MyWebSearch MCP

    iuiu-py
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to perform unified web research through a single MCP server, including search, page fetching, recursive crawling, document parsing, YouTube transcript extraction, and deep multi-query research.
    2

View all related MCP servers

Related MCP Connectors

  • Aginx Browser

    Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.

  • web-scraper

    Web tools for agents: fetch URL as markdown (free MCP) + x402 scrape, links, AI JSON, snapshot.

  • agentsearch-mcp

    LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chenxuyaun/free_web_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server