web-browser-mcp-server
✨ 特徴
🌐 AI アシスタントがシンプルな MCP インターフェースを介して Web からコンテンツを閲覧および抽出できるようにします。
WebブラウザMCPサーバーは、メッセージ制御プロトコル(MCP)を介してAIモデルにウェブサイトの閲覧、コンテンツの抽出、ウェブページの理解機能を提供します。CSSセレクターによるスマートなコンテンツ抽出と堅牢なエラー処理を実現します。
Related MCP server: mcp-web-tools
✨ コア機能
🎯スマートコンテンツ抽出: CSSセレクターで必要なものを正確にターゲットします
⚡超高速: 非同期処理で最適なパフォーマンスを実現
📊豊富なメタデータ: タイトル、リンク、構造化コンテンツをキャプチャします
🛡️堅牢性と信頼性: エラー処理とタイムアウト管理が組み込まれています
🌍クロスプラットフォーム: Pythonが動作する場所ならどこでも動作します
🚀 クイックスタート
Smithery経由でインストール
Smithery経由で Claude Desktop の Web ブラウザ サーバーを自動的にインストールするには:
npx -y @smithery/cli install web-browser-mcp-server --client claude手動でインストールする
uv を使用してインストールします。
uv tool install web-browser-mcp-server開発の場合:
# Clone and set up development environment
git clone https://github.com/blazickjp/web-browser-mcp-server.git
cd web-browser-mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install with test dependencies
uv pip install -e ".[test]"🔌 MCP統合
この構成を MCP クライアント構成ファイルに追加します。
{
"mcpServers": {
"web-browser-mcp-server": {
"command": "uv",
"args": [
"tool",
"run",
"web-browser-mcp-server"
],
"env": {
"REQUEST_TIMEOUT": "30"
}
}
}
}開発の場合:
{
"mcpServers": {
"web-browser-mcp-server": {
"command": "uv",
"args": [
"--directory",
"path/to/cloned/web-browser-mcp-server",
"run",
"web-browser-mcp-server"
],
"env": {
"REQUEST_TIMEOUT": "30"
}
}
}
}💡 利用可能なツール
サーバーは強力な Web 閲覧ツールを提供します。
ウェブページを参照
オプションの CSS セレクターを使用して Web ページからコンテンツを参照および抽出します。
# Basic webpage fetch
result = await call_tool("browse_webpage", {
"url": "https://example.com"
})
# Target specific content with CSS selectors
result = await call_tool("browse_webpage", {
"url": "https://example.com",
"selectors": {
"headlines": "h1, h2",
"main_content": "article.content",
"navigation": "nav a"
}
})⚙️ 構成
環境変数を使用して設定します。
変数 | 目的 | デフォルト |
| ウェブページリクエストのタイムアウト(秒) | 30 |
🧪 テスト
テスト スイートを実行します。
python -m pytest📄 ライセンス
MITライセンスに基づいてリリースされています。詳細はLICENSEファイルをご覧ください。
Pear Labsチームが心を込めて作りました
Available Tools
1 toolbrowse_webpageC
Extract content from a webpage with optional CSS selectors for specific elements
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL of the webpage to browse | |
| selectors | No | Optional CSS selectors to extract specific content |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool extracts content but fails to describe critical behaviors such as error handling (e.g., invalid URLs, network issues), performance traits (e.g., timeouts, rate limits), or output format. This leaves significant gaps in understanding how the tool operates beyond its basic function.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core purpose. It avoids redundancy and wastes no words, though it could be slightly more informative without sacrificing brevity. The structure is clear and direct, earning a high score for conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (web scraping with optional selectors), lack of annotations, and no output schema, the description is incomplete. It doesn't explain what 'content' includes (e.g., text, links, structure), how selectors are applied, or potential limitations (e.g., JavaScript-rendered content). This leaves the agent with insufficient context for reliable use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents both parameters ('url' and 'selectors') adequately. The description adds minimal value by mentioning 'optional CSS selectors for specific elements,' which aligns with the schema but doesn't provide additional syntax, examples, or constraints. This meets the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('Extract') and resource ('content from a webpage'), and mentions optional CSS selectors for refinement. It distinguishes the tool's core function effectively, though without sibling tools, differentiation isn't applicable. However, it lacks specificity about what 'content' entails (e.g., text, HTML, metadata), which prevents a perfect score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, prerequisites, or limitations. It mentions optional CSS selectors but doesn't explain when they are beneficial or necessary. With no sibling tools, context for usage is minimal, but the absence of any usage context results in a low score.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- First observed
browse_webpage
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap with other tools. The tool's purpose is clearly defined as extracting webpage content with optional element selection.
The single tool name follows a clear verb_noun pattern (browse_webpage). Since there are no other tools to compare against, consistency is inherently perfect.
A single tool for a web browser server is too minimal for the apparent scope. Basic web interactions like navigation, clicking, form filling, or handling multiple tabs are missing, making the server feel incomplete and limiting for agents.
The server is severely incomplete for a web browser domain. It only offers content extraction, lacking essential operations such as navigation, interaction with page elements, or session management, which are critical for typical web automation tasks.
Maintenance
Related MCP Connectors
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Web search, URL content extraction to Markdown, site mapping, and recursive web crawler.
Scrape, crawl and search the web for AI agents via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables web browsing capabilities for locally served LLMs through URL text fetching, link extraction, and web search using Brave and DuckDuckGo engines. Designed to enhance LLMs with real-time web access through the MCP protocol.MIT
- AlicenseAqualityDmaintenanceProvides web access capabilities for LLMs including search, fetching, content extraction, PDF reading, image viewing, and screenshots.346MIT
- AlicenseAqualityDmaintenanceEnables web scraping of URLs, including extracting text, links, images, metadata, taking screenshots, and using CSS selectors for structured data extraction.610 npmMIT
- AlicenseAqualityCmaintenanceEnables AI assistants to browse and interact with websites via WebUplink, providing browser automation tools like browse and close_session.236 npm1MIT