How do I use @chenpu17/web-bridge-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@chenpu17/web-bridge-mcp search for latest React documentation" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@chenpu17/web-bridge-mcp

by chenpu17

Overview Schema Related Servers Score Discussions

TypeScript

@chenpu17/web-bridge-mcp

npm version License: MIT

支持代理配置的 MCP Server，提供 Web 搜索、网页抓取，以及官方 Context7 文档能力透传。

专为内网环境设计，让无法直接访问外网的 AI 编程工具（如 Claude Code、OpenCode）也能获取互联网信息。

特性

代理支持: 支持 system（自动检测系统代理）、none（不使用代理）、自定义代理 URL
Windows 系统代理检测: 自动读取 Windows 注册表获取系统代理配置
SSL 证书忽略: 支持忽略 SSL 证书校验，解决代理导致的证书问题
多种搜索引擎: DuckDuckGo（免费）、Exa AI、博查 AI
网页抓取: 支持 Markdown、纯文本、HTML 格式输出
官方 Context7 透传: 直连 https://mcp.context7.com/mcp，暴露官方 resolve-library-id / query-docs 工具
Context7 默认开启: 启动后默认同时暴露搜索、抓取、Context7 文档工具，无需额外参数
Context7 可选鉴权: 支持 CONTEXT7_API_KEY，不配置也可匿名基础使用
Context7 容错更稳: 远端工具发现失败时保留内置 fallback 元数据，临时网络抖动时自动重连重试一次
npx 运行: 无需安装，一条命令即可使用

Related MCP server: Context7 MCP Server

快速开始

# 使用 npx 直接运行（推荐）
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl

# 或全局安装
npm install -g @chenpu17/web-bridge-mcp
web-bridge-mcp --proxy system --ignore-ssl

使用方法

基本用法

# 使用 DuckDuckGo 搜索（默认，免费无需配置）
npx @chenpu17/web-bridge-mcp

# 使用系统代理
npx @chenpu17/web-bridge-mcp --proxy system

# 指定代理地址
npx @chenpu17/web-bridge-mcp --proxy http://proxy.company.com:8080

# 忽略 SSL 证书校验（解决代理证书问题）
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl

启用 Context7

# Context7 默认已启用
npx @chenpu17/web-bridge-mcp

# 内网推荐：系统代理 + 忽略 SSL + Context7
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl

# 配置 Context7 API Key（可选，提高限额）
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl --context7-api-key ctx7sk_xxx

# 如需显式关闭 Context7
npx @chenpu17/web-bridge-mcp --no-context7

搜索引擎配置

# DuckDuckGo（默认，免费）
npx @chenpu17/web-bridge-mcp --web-search duckduckgo

# Exa AI（AI 优化搜索）
npx @chenpu17/web-bridge-mcp --web-search exa

# 博查 AI（中文友好，需要 API Key）
npx @chenpu17/web-bridge-mcp --web-search bocha --bocha-api-key sk-xxx

完整示例（企业内网推荐配置）

# 使用系统代理 + 忽略 SSL + DuckDuckGo + 官方 Context7
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl

# 使用系统代理 + 忽略 SSL + 博查搜索 + 官方 Context7
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl --web-search bocha --bocha-api-key sk-xxx

环境变量

变量名	说明
`HTTPS_PROXY` / `HTTP_PROXY`	代理地址
`BOCHA_API_KEY`	博查 AI 的 Bearer Token
`CONTEXT7_API_KEY`	Context7 API Key（可选）
`CONTEXT7_MCP_URL`	Context7 MCP URL，默认 `https://mcp.context7.com/mcp`
`ENABLE_CONTEXT7`	是否启用 Context7；默认启用，设置为 `false` 可关闭
`IGNORE_SSL`	忽略 SSL 证书校验 (设置为 `true`)
`NODE_TLS_REJECT_UNAUTHORIZED`	设置为 `0` 也可忽略 SSL

命令行参数

参数	说明	默认值
`-p, --proxy <proxy>`	代理设置: system \| none \| http://...	none
`--web-search <engine>`	搜索引擎: duckduckgo \| exa \| bocha	duckduckgo
`--bocha-api-key <key>`	博查 AI API Key	-
`-t, --timeout <ms>`	请求超时时间(毫秒)	30000
`--ignore-ssl`	忽略 SSL 证书校验	false
`--no-context7`	禁用官方 Context7 MCP 透传	默认启用
`--context7-api-key <key>`	Context7 API Key（可选）	-
`--context7-url <url>`	Context7 MCP URL	`https://mcp.context7.com/mcp`

检测系统代理

npx @chenpu17/web-bridge-mcp detect-proxy

诊断代理连接

测试代理配置是否正常工作，包括连接测试、搜索测试和抓取测试：

# 使用系统代理进行诊断
npx @chenpu17/web-bridge-mcp diagnose

# 使用指定代理进行诊断
npx @chenpu17/web-bridge-mcp diagnose --proxy http://proxy.company.com:8080

# 忽略 SSL 证书进行诊断
npx @chenpu17/web-bridge-mcp diagnose --proxy system --ignore-ssl

# 默认会额外测试 Context7 连通性
npx @chenpu17/web-bridge-mcp diagnose --proxy system --ignore-ssl

# 如需跳过 Context7 测试
npx @chenpu17/web-bridge-mcp diagnose --proxy system --ignore-ssl --no-context7

诊断命令会自动测试：

代理检测 - 检查代理配置是否正确
连接测试 - 测试是否能通过代理访问互联网
搜索测试 - 测试 DuckDuckGo 搜索功能
抓取测试 - 测试网页内容抓取功能
Context7 测试（默认启用）- 测试官方 Context7 工具发现与调用

每个步骤都会显示详细的测试结果和响应时间，帮助快速定位问题。

如果你准备发布新版本，建议在本机或目标网络环境里至少手动跑一次 diagnose，确认代理、匿名访问或 API Key 配置都正常。

MCP 工具

web_search

搜索互联网获取信息。

参数:

query (string): 搜索查询内容
numResults (number, 可选): 返回结果数量，默认 8

web_fetch

抓取指定 URL 的网页内容。

参数:

url (string): 要抓取的 URL
format (enum, 可选): 返回格式 - markdown / text / html，默认 markdown
timeout (number, 可选): 超时时间(秒)，最大 120

resolve-library-id

官方 Context7 工具，解析库名并返回 Context7 兼容的 library ID。

参数:

query (string): 当前要完成的任务或问题
libraryName (string): 要查找的库名

query-docs

官方 Context7 工具，根据 library ID 检索最新文档和代码示例。

参数:

libraryId (string): Context7 兼容库 ID，例如 /vercel/next.js
query (string): 具体问题或任务

在 Claude Code 中使用

在 Claude Code 的配置文件中添加 MCP Server：

{
  "mcpServers": {
    "proxy-web": {
      "command": "npx",
      "args": [
        "@chenpu17/web-bridge-mcp",
        "--proxy", "system",
        "--ignore-ssl",
        "--web-search", "duckduckgo"
      ]
    }
  }
}

如果使用博查搜索：

{
  "mcpServers": {
    "proxy-web": {
      "command": "npx",
      "args": [
        "@chenpu17/web-bridge-mcp",
        "--proxy", "system",
        "--ignore-ssl",
        "--web-search", "bocha",
        "--bocha-api-key", "sk-xxx"
      ]
    }
  }
}

如果 Context7 需要更高限额，可追加 API Key：

{
  "mcpServers": {
    "proxy-web": {
      "command": "npx",
      "args": [
        "@chenpu17/web-bridge-mcp",
        "--proxy", "system",
        "--ignore-ssl",
        "--context7-api-key", "ctx7sk_xxx"
      ]
    }
  }
}

搜索引擎对比

搜索引擎	免费	鉴权方式	特点
DuckDuckGo	✅	无需	免费、无限制，结果质量一般
Exa AI	❌	无需（MCP端点）	AI 优化搜索，结果质量高
博查 AI	❌	Bearer Token	中文搜索友好

常见问题

1. 代理证书错误

如果遇到 UNABLE_TO_VERIFY_LEAF_SIGNATURE 错误，请添加 --ignore-ssl 参数：

npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl

2. Windows 系统代理未检测到

确保系统代理已正确配置：

打开「设置」→「网络和 Internet」→「代理」
检查「使用代理服务器」是否已开启

3. 博查搜索认证失败

确保 API Key 正确，可以通过环境变量或命令行参数配置：

# 方式1: 命令行参数
npx @chenpu17/web-bridge-mcp --web-search bocha --bocha-api-key sk-xxx

# 方式2: 环境变量
export BOCHA_API_KEY=sk-xxx
npx @chenpu17/web-bridge-mcp --web-search bocha

4. Context7 是否必须鉴权？

不是必须。官方远端 MCP 在很多场景下支持匿名基础使用，但限额更低。

如果你在企业内网长期使用，建议配置 CONTEXT7_API_KEY 或 --context7-api-key，这样更稳定，也更接近官方推荐方式：

export CONTEXT7_API_KEY=ctx7sk_xxx
npx @chenpu17/web-bridge-mcp --proxy system --ignore-ssl

开发

# 克隆仓库
git clone https://github.com/chenpu/web-bridge-mcp.git
cd web-bridge-mcp

# 安装依赖
npm install

# 开发模式
npm run dev -- --proxy system --ignore-ssl

# 构建
npm run build

# 运行构建产物
npm start -- --proxy system --ignore-ssl

# 运行测试
npm test

# 代码质量检查
npm run lint

# 格式化代码
npm run format

# 类型检查
npm run typecheck

贡献指南

Fork 本仓库
创建特性分支 (git checkout -b feature/amazing-feature)
运行测试确保通过 (npm test)
运行 lint 检查 (npm run lint)
提交更改
推送到分支
创建 Pull Request

技术栈

Runtime: Node.js >= 18
Language: TypeScript
Framework: MCP SDK
Testing: Vitest
Linting: ESLint + TypeScript ESLint
Formatting: Prettier

安全性

SSRF 防护

本项目实现了多层 SSRF (Server-Side Request Forgery) 防护：

内网 IP 段阻止: 自动阻止访问私有 IP 地址
敏感端口过滤: 禁止访问数据库、邮件等敏感服务端口
IPv6 支持: 同时检测 IPv4 和 IPv6 内网地址
本地地址拦截: 阻止 localhost 和本地回环地址

最佳实践

使用环境变量存储敏感信息（API Keys）
支持忽略 SSL 证书校验（仅限受信任的网络环境）
响应大小限制（5MB）
请求超时控制

License

MIT © chenpu

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

5Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

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

MCP Server Fetch Python
Web Scraping App Automation Browser Automation
tatn
A
license
A
quality
C
maintenance
An MCP server for fetching and transforming web content into various formats.
Updated a year ago (2025-04-04 23:13 UTC)
4
8
MIT
Context7 MCP Server
Documentation Access Search Developer Tools
quiint
A
license
-
quality
D
maintenance
An MCP server that bridges to the Context7 API, enabling querying documentation context, searching projects, and retrieving project metadata.
Updated a year ago (2025-05-28 20:19 UTC)
24
4
MIT
webx-mcp-server
Browser Automation Web Scraping Search
ceeyang-ai
A
license
A
quality
B
maintenance
An MCP server for web content extraction, providing tools to fetch clean text, extract links, query by CSS selector, and search the web via DuckDuckGo.
Updated 2 months ago (2026-06-18 19:20 UTC)
4
MIT
mcp-docs
Documentation Access Search RAG Systems
pgupta1795
A
license
-
quality
D
maintenance
MCP server for documentation search that automatically indexes web documentation sites and provides semantic, full-text, or hybrid search capabilities.
Updated 7 months ago (2026-01-19 14:46 UTC)
8
MIT

View all related MCP servers

Related MCP Connectors

VPN.FAIL MCP
Free remote MCP server for fetching public web pages through a rotating proxy pool.
Parallel Task MCP
An MCP server for deep research or task groups
network
MCP server for network documentation, generated by doc2mcp.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/chenpu17/web-bridge-mcp'

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

@chenpu17/web-bridge-mcp

特性

快速开始

使用方法

基本用法

启用 Context7

搜索引擎配置

完整示例（企业内网推荐配置）

环境变量

命令行参数

检测系统代理

诊断代理连接

MCP 工具

web_search

web_fetch

resolve-library-id

query-docs

在 Claude Code 中使用

搜索引擎对比

常见问题

1. 代理证书错误

2. Windows 系统代理未检测到

3. 博查搜索认证失败

4. Context7 是否必须鉴权？

开发

贡献指南

技术栈

安全性

SSRF 防护

最佳实践

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

MCP Server Fetch Python

Context7 MCP Server

webx-mcp-server

mcp-docs

Related MCP Connectors

Latest Blog Posts

MCP directory API