Token导航 LogoToken导航

MCP Server · 浏览器工具

Ferrum MCP

FerrumMCP是一个实现模型上下文协议(MCP)的浏览器自动化服务器,为AI助手提供通过标准化界面与网页交互的能力。

stdio官方级别未说明来源级核验工具 0
RubyDockerClaude会话管理Claude Desktop

快速开始

作者 / 组织
Eth3rnit3
提供方
Eth3rnit3
运行时
Docker

工具数量

0

来源目录标注

资源数量

0

来源目录标注

提示词数量

0

来源目录标注

GitHub Star

29

仓库热度

收录来源

1 个

MCP World

选型结论

Ferrum MCP 属于浏览器工具类 MCP Server,公开资料标注 0 个工具,通过stdio 本地进程接入,适配 Claude Desktop、Claude,有可以直接复制的安装命令;接入前要先准备 会话凭据。

分类

浏览器工具

传输方式

stdio

认证方式

会话凭据

部署方式

公开资料未说明

安装与配置

安装命令

docker run --security-opt seccomp=unconfined -p 3000:3000 eth3rnit3/ferrum-mcp:latest

客户端配置示例

{
  "mcpServers": {
    "ferrummcp": {
      "command": "docker",
      "args": [
        "run",
        "--security-opt",
        "seccomp=unconfined",
        "-p",
        "3000:3000",
        "eth3rnit3/ferrum-mcp:latest"
      ]
    }
  }
}

按公开安装命令拼出来的示例,字段名和参数以仓库 README 为准;带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

  1. 1

    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2

    安装服务

    复制下面的安装命令执行;命令里带占位符的位置换成自己的密钥或路径。

  3. 3

    写入客户端配置

    在客户端的 MCP 配置里填启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4

    验证是否可用

    连接成功后客户端会列出 0 个工具,随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

详细介绍

铁MCP🌐

用于模型上下文协议(MCP)的浏览器自动化服务器,使AI助手能够通过标准化的界面与网页进行交互。

______________________________________________________________________

🚀 快速链接

文档描述
入门指南安装、设置和第一步
使用Claude Desktop集成完成Docker指南
API 参考所有27+工具的完整文档
配置环境变量和高级配置
故障排除常见问题和解决方案
部署生产部署指南
BotBrowser集成防检测浏览器设置

______________________________________________________________________

📖 目录

______________________________________________________________________

什么是FerrumMCP?

FerrumMCP是一种 浏览器自动化服务器 这实现了 模型上下文协议(MCP) 通过Anthropic。它为人工智能助手提供了导航网站、与元素交互、提取内容以及通过简单、标准化的界面执行复杂浏览器自动化任务的能力。

主要优势:

  • 🤖 AI原生设计:专为克劳德等人工智能助手打造
  • 🔄 基于会话:具有隔离配置的多个并发浏览器会话
  • 🌐 多浏览器:支持Chrome、Edge、Brave和BotBrowser
  • 🧩 智能自动化:Cookie横幅检测和验证码解决(⚠️ 实验)
  • 📦 轻松部署:Docker、systemd或Kubernetes就绪
  • 🔌 双重运输:HTTP和STDIO实现最大兼容性

______________________________________________________________________

特性

核心能力

✅ 会话管理

  • 创建/管理多个浏览器会话
  • 自动清理(30分钟空闲超时)
  • 每个会话的自定义浏览器配置

✅ 导航

  • 带有网络空闲检测的URL导航
  • 浏览器历史记录(后退/前进)
  • 页面刷新

✅ 交互

  • 点击、悬停、拖放
  • 填写表格时出现打字延迟
  • 键盘输入模拟
  • 智能cookie横幅接受 (8种策略,多语言)
  • 基于人工智能的验证码解决方案 (Whisper集成-⚠️ 实验中,开发中)

✅ 提取

  • 文本和HTML内容提取
  • 屏幕截图(base64)
  • 页面元数据(标题、URL)
  • 基于XPath的文本搜索

✅ 高级

  • JavaScript执行和评估
  • Cookie管理(获取/设置/清除)
  • 影子DOM查询
  • 元素属性检索

企业功能

🦾 BotBrowser集成

  • 反检测浏览器自动化
  • 使用加密配置文件进行指纹管理
  • 备注:需要有效的试用/高级配置文件(演示配置文件会导致会话不稳定)

🔒 安全 (v1.0+)

  • 会话限制
  • 速率限制
  • 健康检查端点
  • 非root Docker用户

📊 可观测性

  • 基于文件的日志记录
  • 健康检查
  • 指标终点(计划)

______________________________________________________________________

快速开始

选项1:Docker(推荐)

标准图像 (仅铬):

docker pull eth3rnit3/ferrum-mcp:latest
docker run --security-opt seccomp=unconfined -p 3000:3000 eth3rnit3/ferrum-mcp:latest

BotBrowser图片 (反检测):

docker pull eth3rnit3/ferrum-mcp:botbrowser
docker run --security-opt seccomp=unconfined -p 3000:3000 \
  -v /path/to/bot_profiles:/profiles:ro \
  -e "BROWSER_BOTBROWSER=botbrowser:/opt/botbrowser/chrome:BotBrowser:Anti-detection browser" \
  -e "BOT_PROFILE_MACOS_1=/profiles/profile_1.enc:Profile 1:Trial profile 1" \
  eth3rnit3/ferrum-mcp:botbrowser

选项2:宝石安装

gem install ferrum-mcp
ferrum-mcp start

选项3:来源

git clone https://github.com/Eth3rnit3/FerrumMCP.git
cd FerrumMCP
bundle install
ruby bin/ferrum-mcp

➡️ 完整安装指南

______________________________________________________________________

文档

入门指南

指南说明
安装Docker、gem和源代码安装
Claude桌面设置与克劳德桌面(STDIO)集成
第一届会议创建您的第一个浏览器自动化

配置

主题链接
环境变量配置指南
多浏览器设置多浏览器配置
BotBrowser集成植物浏览器指南
资源发现资源配置

API 文档

资源描述
API 参考完整的工具文档和示例
会话管理创建、列出和管理浏览器会话
导航工具URL导航和历史记录
交互工具点击、填写表格、解决验证码
提取工具获取内容、截图、元数据
高级工具JavaScript、Cookie、Shadow DOM

运营

指南说明
故障排除常见问题和解决方案
部署Docker、K8s、systemd部署
迁移版本之间的升级

______________________________________________________________________

工具和功能

FerrumMCP提供 27+浏览器自动化工具 分为6类:

1.会话管理(4个工具)

  • create_session -使用自定义配置创建浏览器会话
  • list_sessions -列出所有活动会话
  • get_session_info -获取详细的会话信息
  • close_session -手动关闭会话

2.导航(4个工具)

  • navigate -导航到URL
  • go_back -浏览器后退按钮
  • go_forward -浏览器前进按钮
  • refresh -重新加载当前页面

3.互动(7个工具)

  • click -点击元素
  • fill_form -填写表单字段
  • press_key -键盘输入
  • hover -鼠标悬停
  • drag_and_drop -拖动元素
  • accept_cookies - 智能cookie横幅检测 (8个策略)
  • solve_captcha - 基于人工智能的验证码解决方案 (⚠️ 实验中,开发中)

4.提取(6个工具)

  • get_text -提取文本内容
  • get_html -获取HTML内容
  • screenshot -截图
  • get_title -获取页面标题
  • get_url -获取当前URL
  • find_by_text -XPath文本搜索

5.高级(9个工具)

  • execute_script -运行JavaScript
  • evaluate_js -使用返回值评估JavaScript
  • get_cookies -获取浏览器Cookie
  • set_cookie -设置Cookie
  • clear_cookies -清除Cookie
  • get_attribute -获取元素属性
  • query_shadow_dom -与Shadow DOM交互

6.MCP资源(7个资源)

  • ferrum://browsers -发现已配置的浏览器
  • ferrum://user-profiles -发现Chrome配置文件
  • ferrum://bot-profiles -发现BotBrowser配置文件
  • ferrum://capabilities -服务器功能

➡️ 完整的API参考资料

______________________________________________________________________

项目资源

发展

资源链接
贡献指南贡献.md
安全策略安全.md
更新日志更改日志.md
AI开发指南CLAUDE.md

社区

平台链接
GitHub问题报告错误
GitHub讨论提出问题
Docker 中心三氟乙烷/铁mcp

链接

资源URL
仓库https://github.com/Eth3rnit3/FerrumMCP
文档https://github.com/Eth3rnit3/FerrumMCP/tree/main/docs
发布https://github.com/Eth3rnit3/FerrumMCP/releases
RubyGemshttps://rubygems.org/gems/ferrum-mcp

______________________________________________________________________

需求

系统要求

  • 红宝石:3.2或更高
  • 浏览器:铬、铬、Edge或Brave
  • 操作系统:Linux、macOS或Windows

可选依赖关系

  • 耳语cli:用于验证码解决
  • 植物浏览器:用于反检测自动化
  • 码头工人:用于集装箱化部署

______________________________________________________________________

贡献

我们欢迎捐款!请查看我们的 贡献指南 了解详情。

快速捐款清单:

  • 📖 阅读 贡献.md
  • 🐛 使用问题模板查找错误
  • ✨ 使用功能请求模板
  • ✅ 运行测试: bundle exec rspec
  • 📝 更新文档
  • 🎨 遵循RuboCop风格

______________________________________________________________________

安全

有关安全漏洞,请发送电子邮件至 eth3rnit3@gmail.com。参见 安全.md 我们的安全政策。

______________________________________________________________________

许可证

FerrumMCP在 MIT许可证.

______________________________________________________________________

鸣谢

内置:

______________________________________________________________________

支持

______________________________________________________________________

Made with ❤️ by Eth3rnit3

Back to Top

工具与能力

工具数量

0

资源数量

0

提示词数量

0

能力标签

Ruby本地部署浏览器自动化AI助手会话管理智能交互多浏览器支持

支持客户端

Claude DesktopClaude

数量来自来源目录的标注,具体工具清单以官方文档为准。

典型使用场景

自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

走一遍关键流程

按步骤检查页面是否正常,回归时少漏环节。

选择建议

值得选的地方

  • 只提供 0 个工具,职责集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已经适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好 Docker,换机器要重新装一遍。
  • 需要自备会话凭据,没有凭据没法直接试。
  • 第三方目录整理,版本更新和行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 暂时拿不到会话凭据的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

5 个同类
MCP Server工具数传输方式安装命令收录来源最后核验
Ferrum MCP

MCP World · 本页

0stdio有1 个2026-05-17
Fetch 9a2682de

MCP.so

1SSE有3 个2026-05-17
Browser 738d52bc

MCP World

0stdio有1 个2026-05-17
Playwright MCP Server

MCP.so

21stdio有4 个2026-05-17
Skyvern MCP

MCP World

0stdio有2 个2026-05-17

按同分类和工具数量挑出最接近的几条,字段以各自详情页为准。

常见问题

5 条

Ferrum MCP 怎么安装?

公开资料给出的安装命令是 docker run --security-opt seccomp=unconfined -p 3000:3000 eth3rnit3/ferrum-mcp:latest,运行环境为 Docker。装完后按客户端要求写进 MCP 配置,重启客户端生效。

Ferrum MCP 怎么在 Claude Desktop、Cursor 里配置?

它是stdio 本地进程,客户端配置里要写启动命令和参数,运行环境是 Docker;保存后完全退出客户端再打开,配置才会生效。

Ferrum MCP 收费吗?

本站只整理公开资料,不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ferrum MCP 需要 API Key 吗?

公开资料标注的认证方式是会话凭据,也就是要先拿到凭据才能连上;凭据只填在自己本地的配置里,不要写进公开仓库。

Ferrum MCP 支持哪些客户端?

公开资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

来源信息

继续浏览同类 MCP