Web Browser Mcp Server

✨ 功能特性

🌐 通过简单的 MCP 接口，让 AI 助手能够浏览网页并提取内容。

Web Browser MCP 服务通过消息控制协议（MCP）让 AI 模型能够浏览网站、提取内容并理解网页。它支持使用 CSS 选择器智能提取内容，并具备可靠的错误处理机制。

✨ 核心功能

• 🎯 智能内容提取：通过 CSS 选择器精准定位所需内容
• ⚡ 极速运行：采用异步处理，提供最佳性能
• 📊 丰富的元数据：获取标题、链接和结构化内容
• 🛡️ 稳健可靠：内置错误处理和超时管理
• 🌍 跨平台：可在所有支持 Python 的平台上运行

🚀 快速开始

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Web Browser Server：

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"
            }
        }
    }
}

💡 可用工具

此服务提供了强大的网页浏览工具：

browse_webpage

浏览网页并提取内容，可选使用 CSS 选择器：

# 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"
    }
})

⚙️ 配置

通过环境变量进行配置：

变量	用途	默认值
REQUEST_TIMEOUT	网页请求超时时间（秒）	30

🧪 测试

运行测试套件：

python -m pytest

📄 许可证

本项目采用 MIT 许可证发布。详情请参阅 LICENSE 文件。

---