obscura-mcp

一个用于 Obscura 的 MCP 服务器适配器，Obscura 是一个用于网页抓取和 AI 智能体自动化的轻量级 Rust 无头浏览器。

通过简洁的 MCP 接口公开 Obscura 原生的 CDP 功能 —— 无需 Chrome 依赖，无需重量级的浏览器自动化。

安装

npm install -g obscura-mcp

安装是即时的 —— 浏览器二进制文件（约 80 MB）会在首次使用时延迟下载。

安装后，您可以：

• 运行 obscura-mcp install 以可见的进度下载二进制文件，或者

• 直接运行 obscura-mcp —— 它会自动下载二进制文件并启动服务器

二进制文件缓存于 ~/.obscura/bin/，在 npm 升级后依然保留。

要使用自定义二进制路径：

export OBSCURA_PATH=/path/to/obscura

Related MCP server: Algonius Browser

快速开始

# Install
npm install -g obscura-mcp

# Verify
obscura-mcp --version

# Download browser binary
obscura-mcp install

# Start MCP server
obscura-mcp --transport stdio

工具

browse_url

使用 Obscura 的 CDP 引擎获取 URL。返回页面内容。

参数：

• url (string, 必填): 要访问的 HTTP 或 HTTPS URL。

• dump (string, 可选): html、text 或 links。默认为 html。

• cookies (array, 可选): 导航前注入的 Cookie。接受与 browse_cookies 返回格式相同的格式 —— 传入从真实浏览器导出的 Cookie 以访问已认证的页面。

• stealth (boolean, 可选): 为兼容性而接受。隐身行为由 Obscura 服务器控制。

browse_evaluate

导航到 URL 并在页面上下文中执行 JavaScript。返回评估结果。

参数：

• url (string, 必填): 要访问的 URL。

• expression (string, 必填): 要评估的 JavaScript 表达式。示例：document.title、navigator.userAgent、document.querySelector('h1').textContent。

• stealth (boolean, 可选): 为兼容性而接受。

browse_cookies

导航到 URL 并检索页面设置的所有 Cookie。返回每个 Cookie 的名称、值、域、路径和过期时间。

参数：

• url (string, 必填): 要访问的 URL。

• stealth (boolean, 可选): 为兼容性而接受。

配置

Claude Desktop / Cline / Continue / 任何 MCP 客户端

{
  "mcpServers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

VS Code (Cline 扩展)

{
  "servers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

全局 npm 安装后，obscura-mcp 就在您的 PATH 中 —— 无需绝对路径。

环境变量

为什么选择 Obscura？

• 无 Chrome —— 纯 Rust，没有 200 MB 的浏览器包

• CDP 原生 —— 直接公开 Chrome DevTools Protocol

• 反检测 —— 内置针对反爬虫网站的隐身功能

• 极小占用 —— 约 15 MB 的二进制文件，毫秒级启动

许可证

MIT