网页浏览器MCP服务器

Name: 网页浏览器MCP服务器
Author: blazickjp

作者：blazickjp42 星标更新：2025-03-06

项目介绍

✨ 特性

🌐 通过简单的MCP接口使AI助手能够浏览和提取网络内容。

Web Browser MCP Server 提供了通过消息控制协议（MCP）让AI模型浏览网站、提取内容并理解网页的能力。它支持使用CSS选择器进行智能内容提取，并具有强大的错误处理功能。

🤝 贡献 • 📝 报告错误

</div>

✨ 核心特性

🎯 智能内容提取：使用CSS选择器精确获取所需内容
⚡ 闪电般快速：采用异步处理以实现最佳性能
📊 丰富的元数据：捕获标题、链接和结构化内容
🛡️ 强大且可靠：内置错误处理和超时管理
🌍 跨平台：在Python运行的任何地方都能工作

🚀 快速开始

通过Smithery安装

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

npx -y @smithery/cli install web-browser-mcp-server --client claude

手动安装

使用uv安装：

uv tool install web-browser-mcp-server

对于开发：

# 克隆并设置开发环境
git clone https://github.com/blazickjp/web-browser-mcp-server.git
cd web-browser-mcp-server

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate

# 安装测试依赖项
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选择器：

# 基本网页抓取
result = await call_tool("browse_webpage", {
    "url": "https://example.com"
})

# 使用CSS选择器定位特定内容
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文件。

由Pear Labs团队制作 ❤️

</div>