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)

검색 후 Top 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