Skip to main content
Glama
leemind-q

Hermes Browser MCP Server

by leemind-q

Hermes Browser V12

AI-powered Electron browser with MCP-First architecture for engineers.

Status (2026-07-11): V12 complete. 157 unit PASS + 46/46 eval + 49 MCP tools + 10 LLM providers + Cowork for engineers. Real production-ready.

Tests Tools Providers


🎯 V12 Three Differentiators

1. MCP-First Architecture

Everything exposed as MCP tools (49 total). External AI agents (Claude, GPT, Hermes AI, etc.) can fully control the browser via HTTP bridge or stdio server.

Browser navigation, click, fill, autofill, search
Content extraction: page text, tables, forms, links, search results
File management: list, read, search, grep, stat (Cowork)
Network: search Naver, search DDG, extract via URL
Vision: prints PDF, downloads, find text in page
Multimedia: browse screenshots, capture form fields

2. Local-First + BYOK

Local LLM support + 10 cloud providers. No provider lock-in. BYOK (Bring Your Own Key) for all cloud providers.

Provider

Type

Use case

mock

OpenAI-compat

Local mock (opencode-go proxy)

LM Studio

OpenAI-compat

Local inference (:1234)

Ollama

OpenAI-compat

Local inference (:11434)

OpenAI

OpenAI-compat

gpt-4o-mini default

Anthropic

Native /v1/messages

Claude 3.5 Haiku

Google

Native REST

Gemini 2.5 Flash

OpenRouter

OpenAI-compat

Aggregator

MiniMax

Anthropic-compat /anthropic

M3

BrowserOS

OpenAI-compat

Local fork (:8765)

OpenAI-compatible

OpenAI-compat

Custom URL

3. Cowork for Engineers

Files + browser + AI 톡합. BrowserOS Cowork의 κ°•ν™” 버전 β€” 회둜 도메인 νŠΉν™”.

cowork_list    β€” list files by pattern
cowork_read    β€” read text (max 5MB, binary β†’ metadata)
cowork_grep    β€” regex search across files (cross-platform)
cowork_search  β€” by name OR content pattern
cowork_stat    β€” metadata (size, mtime, mime)

Default workspace: C:\Users\qqwer\Hermes-Workspace\


Related MCP server: BrowserMCP Secure

πŸ“¦ 30-Second Quick Start

Test & Run

cd /mnt/c/Users/qqwer/Desktop/Hermes/hermes-browser
npm test           # 157 unit + 46 eval PASS (~3 sec)
npm start          # Launch Electron (Miraecle window)

Live Verification

Hermes Browser auto-starts HTTP bridge on port 8780. Connect from external AI agents:

TOKEN=$(curl -s http://127.0.0.1:8780/auth/token | jq -r .token)

# Call any of 49 tools
curl -X POST http://127.0.0.1:8780/mcp/tool \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"name":"cowork_list","args":{"dir":"demo-circuits"}}'

Use with Claude Code / Cursor / Cline

Add to ~/.claude.json (std둜 MCP μ‚¬μš©):

{
  "mcpServers": {
    "hermes-browser": {
      "command": "node",
      "args": ["C:/Users/qqwer/Desktop/Hermes/hermes-browser/mcp-server/server.js"]
    }
  }
}

πŸ—οΈ Architecture (V12)

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Renderer (src/chrome.html)                            β”‚
β”‚  - Tabs, sidebar, chat UI, settings popover           β”‚
β”‚  - Light/dark theme (Space Grotesk + DM Sans)         β”‚
β”‚  - Spring motion (--ease-spring)                      β”‚
β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       β”‚ IPC                                  β”‚
       β”‚                                      β”‚
β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Main Process      β”‚            β”‚  MCP Bridge          β”‚
β”‚  (main.js)         │◄──────────►│  (HTTP :8780)        β”‚
β”‚  - nativeTheme     β”‚            β”‚  49 tools exposed    β”‚
β”‚  - syncNativeTh..  β”‚            β”‚  localhost only      β”‚
β”‚  - Cowork attach   β”‚            β”‚  Token auth          β”‚
β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       β”‚
β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Agent Service             β”‚
β”‚  (src/agent/index.js)      β”‚
β”‚  - Plan/Mode/Approval      β”‚
β”‚  - ReadingList/Workspace   β”‚
β”‚  - Session Recorder        β”‚
β”‚  - CredentialVault         β”‚
β”‚  - CoworkService (V12)     β”‚
β”‚  - Provider abstraction    β”‚
β”‚  - Scheduler               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Key Files

File

Purpose

main.js

Electron main, theme sync, IPC, MCP bridge attach

src/chrome.html

UI shell with glass + light/dark + spring motion

src/agent/index.js

AgentService (single API entry point)

src/agent/cowork.js

V12 Cowork: files + browser + AI integration

src/mcp-bridge.js

HTTP server exposing 49 tools on port 8780

tests/cowork.test.js

6 unit tests for cross-platform path handling

tests/{agent,credentials,...}.test.js

157 unit tests total

eval/runner.js

46 integration scenarios


πŸ“Š V12 Features (Day 1-5)

Day 1: OS Theme Sync

  • nativeTheme.themeSource = 'system'

  • OS λ³€κ²½ μ‹œ chrome.html data-theme="dark" μžλ™ μ „ν™˜

  • 검증: light 100% #f5f5f7, dark 100% #121212

Day 2: BYOK + 10 LLM Providers

  • Provider presets μžλ™ μ±„μš°κΈ° (URL/model)

  • 3 endpoint νƒ€μž… dispatch (OpenAI-compat / Anthropic native / Google native)

  • 라이브 검증: λͺ¨λ“  10개 provider endpoint 도달

Day 3: MiniMax Endpoint Fix

  • base_url = https://api.minimax.io/anthropic

  • endpoint = {base}/v1/messages

  • Header = X-Api-Key (capitalized)

  • 검증: 401 "login fail: Please carry the API secret key" (endpoint OK)

Day 4: Cowork + 49 Tools + UI Spring Motion

  • src/agent/cowork.js 240+ lines (V12 day 1)

  • 5 public Cowork methods + 13 V12 tools (browser/web extensions)

  • --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1) + 7 keyframes

  • Spring-in/slide/sidebar/chat/pulse/focus animations

Day 5: Cross-Platform Path Fix + 회둜 Demo

  • _safePath cross-platform (Windows path β†’ WSL β†’ /mnt/...)

  • Electron path λͺ¨λ“ˆ (Windows mode) μž‘λ™

  • BD69730FV 회둜 demo (BOM 18 parts, Gerber, datasheet)

  • 5/5 cowork e2e 톡과


πŸ› οΈ Build & Verification

# Run all tests
npm test

# Quick unit-only run
node tests/agent.test.js
node tests/cowork.test.js

# Eval scenarios (46 total)
node eval/runner.js

# Live MCP call examples
curl -s http://127.0.0.1:8780/mcp/tools | jq '.tools | length'

# Open live window
npm start

πŸ“œ License

AGPL-3.0 (no BrowserOS code copy, safeStorage-based credential vault)


🎨 Design Choices

  • Light theme: #f5f5f7 background, white cards + box-shadow, gold #fbbf24 accent

  • Dark theme: #0f0f1e background, glass black 0.72 + blur 24px

  • Fonts: Space Grotesk + DM Sans

  • Spring motion: tagu requested "μ«€λ“ν•œ" easing β€” cubic-bezier(0.34, 1.56, 0.64, 1)

  • Glass: backdrop-filter: blur(24px) for panels/popovers


🀝 Acknowledgements

Inspired by browserOS-ai (AGPL-3) for the MCP-first + cowork architecture. Safe fork β€” no code copied, all implementation original.

F
license - not found
-
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    Enables real browser automation as tools in Cursor, Claude Desktop, Windsurf, and any MCP-compatible client, allowing AI agents to interact with web pages through natural language.
    Last updated
    36
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    Enables AI to control browsers via natural language for web automation, testing, and data scraping. Supports Chrome-based browsers and integrates with any MCP-compatible AI tool.
    Last updated
    2
  • F
    license
    -
    quality
    D
    maintenance
    A browser automation MCP server providing 30 tools for navigation, interaction, page information, state checks, tab management, and more, enabling natural language control of browsers via MCP-compatible clients.
    Last updated

View all related MCP servers

Related MCP Connectors

  • Browser MCP for logged-in tasks. Uses your Chrome β€” credentials stay local. Zero-token replay.

  • Live browser debugging for AI assistants β€” DOM, console, network via MCP.

  • A paid remote MCP for AI agent browser MCP session, built to return verdicts, receipts, usage logs,

View all MCP Connectors

Latest Blog Posts

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/leemind-q/hermes-browser'

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