Orion Browser MCP

基于Orion浏览器的MCP (Machine Communicatin Protocol) 服务，提供浏览器自动化控制能力。

功能特点

支持FastMCP和SSE两种服务模式
提供完整的浏览器控制API，包括导航、点击、输入等操作
支持截图和视觉模式
完善的错误处理和日志记录
模块化设计，易于扩展

安装

要求

Python 3.12+
依赖项: 见 pyproject.toml

步骤

克隆代码库
进入项目目录
创建虚拟环境: python -m venv .venv
激活虚拟环境:
- Windows: .venv\Scripts\activate
- Unix/MacOS: source .venv/bin/activate
安装依赖: pip install -e .

使用方法

基本用法

# 启动FastMCP服务器(默认)
python main.py

# 启用视觉模式
python main.py --vision

# 无头模式
python main.py --headless


### API参考

服务器提供以下工具:

- `go_url`: 导航到指定URL
- `open_tab`: 打开新标签页
- `input_text`: 在元素中输入文本
- `click_element`: 点击指定元素
- `switch_tab`: 切换标签页
- `close_browser`: 关闭浏览器
- `send_keys`: 发送键盘输入
- `scroll_down`/`scroll_up`: 页面滚动
- `scroll_to_text`: 滚动到包含特定文本的元素
- `extract_content`: 提取页面内容
- `click_by_position`: 通过坐标点击页面

## 项目结构

orion_browser_mcp/ ├── init.py # 包初始化文件 ├── main.py # 主入口点 ├── config.py # 配置管理 ├── utils.py # 通用工具函数 ├── browser_actions.py # 浏览器操作封装 ├── server/ # 服务器实现 │ ├── init.py │ ├── fast_server.py # FastMCP服务器


## 贡献

欢迎通过Issue和Pull Request贡献代码和反馈问题。

## 许可

[LICENSE]

Metadata

Release files for orion-browser-mcp 0.4.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for orion-browser-mcp 0.4.7
File	Size	Uploaded	Provenance
orion_browser_mcp-0.4.7.tar.gz	13.2 kB	Jun 13, 2025	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for orion-browser-mcp 0.4.7
File	Interpreter	ABI	Platform	Reset
orion_browser_mcp-0.4.7-py3-none-any.whl 18.8 kB Jun 13, 2025 Without provenance	Python 3	none	any	Details

Total release size: 32.0 kB

Release files / orion_browser_mcp-0.4.7.tar.gz

Download URL	orion_browser_mcp-0.4.7.tar.gz
Size	13.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`c34eec8bf0a9000a3d35db3c43a139e5ee23359a17cbae9de176a33d49a4b5b9`
BLAKE2b-256 checksum How to use checksums	`9da5c7258d21cf8a3d23872bd32e129dbe7329e53e5bf2771e5294289f6b2db5`
Upload date	Jun 13, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.6.17`

Release files / orion_browser_mcp-0.4.7-py3-none-any.whl

Download URL	orion_browser_mcp-0.4.7-py3-none-any.whl
Size	18.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e473e8ba3ed7d4b3ae6c12357d91bbfec47fca97274dde5676aba8fb918ca5a8`
BLAKE2b-256 checksum How to use checksums	`5f3ea06a8cd38bf47545198d276943a346f0b000baf85439ce366c3e37b71620`
Upload date	Jun 13, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.6.17`

Security for orion-browser-mcp 0.4.7

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.