Nik-Browser MCP

ローカルMCPサーバー。LLMに独自の独立したChromiumを提供します。ブラウザ、ログインプロファイル、スクリーンショットはプロジェクトフォルダ内に保存され、通常のChromeやEdgeと混ざりません。

Windows 10/11、LM Studio、および標準のstdioトランスポートを使用する他のMCPクライアントに適しています。

できること

• サイトやタブを開く

• ページのテキストを読み取り、ボタン、リンク、フィールドを見つける

• ボタンやキーを押す

• テキストフィールドに入力する

• リスト項目を選択し、チェックボックスを設定する

• GitHub、Yandex Disk、Google Driveなどのサイトにファイルやフォルダを添付する

• ページのPNGスクリーンショットを撮る

• Gitプロジェクトの一般的なシークレットをチェックする

• さらにGitHub CLIを使ってリポジトリを公開する

Related MCP server: mare-browser-mcp

コンピュータ上に作成されるもの

プロジェクトフォルダ内に以下が作成されます:

• .venv — 独立したPython環境

• browser-runtime — 独自のChromium

• browser-profile — Cookieとサイトへのログイン情報

• screenshots — ページのスクリーンショット

これらのディレクトリはすべてGitから除外されます。

Windows向けクイックインストール

ステップ1. Pythonをインストール

https://www.python.org/downloads/windows/ からPython 3.10以降をダウンロードしてください。

インストーラーの最初の画面で Add Python to PATH にチェックを入れます。

ステップ2. プロジェクトをダウンロード

PowerShellを開いて実行:

cd "$HOME\Desktop"
git clone https://github.com/Nikolay-3D/nik-browser-mcp.git
cd nik-browser-mcp

Gitがインストールされていない場合は、GitHubページの Code → Download ZIP からZIPをダウンロードし、解凍して解凍したフォルダでPowerShellを開いてください。

ステップ3. 自動インストールを実行

powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

スクリプト:

1. .venvを作成

2. Python依存関係をインストール

3. Chromiumをbrowser-runtimeにダウンロード

4. テストとMCPハンドシェイクを実行

5. 完成した設定の断片を出力

手動でのvenvインストール

自動スクリプトが適さない場合:

cd "ПОЛНЫЙ\ПУТЬ\К\nik-browser-mcp"
py -3.10 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

py -3.10が見つからない場合は、py -3を試してください。

Chromiumは接続後にモデルに以下を呼び出させることでインストールできます:

browser_install_runtime с confirm="INSTALL_BROWSER"

または事前にインストール:

$env:PLAYWRIGHT_BROWSERS_PATH = "$PWD\browser-runtime"
.\.venv\Scripts\python.exe -m playwright install chromium

LM Studioへの接続

ステップ1. フルパスを確認

プロジェクトフォルダ内でPowerShellで:

$PWD.Path

例:

C:\Users\Ivan\Desktop\nik-browser-mcp

ステップ2. MCP設定を開く

LM StudioでMCP Serversセクションまたはファイルを開く:

C:\Users\ВАШЕ_ИМЯ\.lmstudio\mcp.json

ステップ3. サーバーを追加

C:\PATH\TO\nik-browser-mcp を実際のフルパスに置き換えてください:

{
  "mcpServers": {
    "Nik-Browser": {
      "command": "C:\\PATH\\TO\\nik-browser-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\PATH\\TO\\nik-browser-mcp\\run_server.py"
      ],
      "env": {
        "MCP_BROWSER_CDP_URL": "http://127.0.0.1:9333",
        "MCP_BROWSER_ALLOWED_ROOTS": "C:\\Users\\ВАШЕ_ИМЯ\\Desktop;C:\\Users\\ВАШЕ_ИМЯ\\Documents;C:\\Users\\ВАШЕ_ИМЯ\\Downloads",
        "PYTHONUTF8": "1"
      }
    }
  }
}

mcp.jsonに既に他のサーバーがある場合は削除しないでください。既存のmcpServers内に"Nik-Browser": {...}ブロックだけを追加し、隣接するブロックの間にカンマを置いてください。

完成したテンプレートはmcp.example.jsonにもあります。

保存後、MCPリストを更新し、サーバーをオフ/オンにするか、LM Studioを再起動してください。

初回起動

モデルに次のように指示:

Запусти собственный браузер через browser_launch, открой github.com и покажи список вкладок.

独立したChromiumウィンドウが開きます。手動で必要なサービスにログインしてください。ログイン情報はbrowser-profileに保存されます。

使い方

モデルは次の順序で動作する必要があります:

1. browser_snapshot — ページのテキストと要素e1、e2などを取得

2. browser_click、browser_fill、browser_select_option、またはbrowser_set_checked — アクションを実行

3. 別のページに移動した後、再度browser_snapshotを呼び出す

識別子e1、e2は一時的なものです。Ref expiredエラーは新しいスナップショットが必要であることを意味します。

検索の例

Открой сайт, найди поле поиска, введи запрос и покажи результаты.

ファイルアップロードの例

Открой Яндекс Диск, найди загрузку и прикрепи файл C:\Users\Ivan\Desktop\report.pdf. Перед окончательной отправкой покажи выбранный файл.

添付にはbrowser_upload_filesをconfirm_external_upload=trueで使用します。添付は最終的な送信ボタンを自動的に押しません。

プロジェクトアップロードの例

Открой Google Drive и загрузи папку C:\Users\Ivan\Desktop\MyProject. Не отправляй ничего, пока не покажешь список файлов.

フォルダをアップロードする際、.git、.venv、venv、node_modules、__pycache__は自動的にスキップされます。一般的なシークレットや秘密鍵はブロックされます。

GitHubへの公開

小さなファイルは通常のブラウザツールを使ってGitHubサイトからアップロードできます。

本格的なGitリポジトリには、GitHub CLIを使った追加の方法が便利です:

1. github_cli_status — インストールとログイン状態を確認

2. github_cli_install(confirm="INSTALL_GH") — wingetでghをインストール

3. 通常のPowerShellでgh auth loginを一度実行

4. git_project_status — プロジェクトとシークレットを確認

5. github_publish_project(..., confirm="PUBLISH") — リポジトリを作成してプッシュ

デフォルトではvisibility="private"を使用してください。公開プロジェクトの場合は明示的にvisibility="public"を指定してください。

インストールの確認

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe smoke_test.py

成功すると次のような行が含まれます:

MCP handshake OK: 19 tools

よくあるエラー

Not connected

• commandとargsの絶対パスを確認

• .venv\Scripts\python.exeが存在するか確認

• smoke_test.pyを実行

• MCPをオフにして再度オンにする

• 解決しない場合はLM Studioを再起動

Private browser runtime is not installed

以下を呼び出してください:

browser_install_runtime(confirm="INSTALL_BROWSER")

Browser did not expose CDP

ポート9333が別のプロセスで使用されています。古いNik-Browserウィンドウを閉じるか、MCP_BROWSER_CDP_URLとbrowser_launchで同じ空きポートを指定してください。

Path is outside MCP_BROWSER_ALLOWED_ROOTS

必要なフォルダをMCP_BROWSER_ALLOWED_ROOTSに追加してください。Windowsではパスはセミコロンで区切ります。変更後、MCPを再起動してください。

セキュリティ

• CDPはlocalhost経由でのみアクセス可能

• browser-profileは絶対に公開しないでください。Cookieとログイン情報が含まれています

• browser-runtimeと.venvをGitに追加しないでください

• モデルに必要なディレクトリのみへのアクセスを許可

• confirm_external_upload=trueの前にサイトとファイルリストを確認

• 詳細: SECURITY.md

ライセンス

MIT — ライセンステキストを保持したまま、使用、変更、再配布が可能です。