@natchs/browser-mcp 2.3.0 → 2.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +63 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -39,6 +39,61 @@ npm run build
|
|
|
39
39
|
npx @natchs/browser-mcp
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
+
### Browser Profili: 3 Mod
|
|
43
|
+
|
|
44
|
+
Ajanın hangi tarayıcıyı kullanacağını `BROWSER_MODE` ortam değişkeni belirler:
|
|
45
|
+
|
|
46
|
+
| Mod | Açıklama | Ne Zaman Kullanılır? |
|
|
47
|
+
|-----|----------|---------------------|
|
|
48
|
+
| `fresh` (default) | Playwright'ın kendi Chromium'u. Her seferinde sıfır profil, çerez/ext/login yok | Temiz ortam, iz bırakmamak |
|
|
49
|
+
| `persistent` | **Senin Chrome profilin.** Gerçek çerezler, geçmiş, uzantılar, oturum açmış hesaplar — hepsi ajana kullanıma hazır | Ajanın sitelere "sen" olarak girmesi gereken işlemler |
|
|
50
|
+
| `connect` | Halihazırda açık Chrome'una CDP ile bağlanır | Chrome'u elle kontrol ederken ajanın eşlik etmesi |
|
|
51
|
+
|
|
52
|
+
**Örnek — persistent (otomatik profil tespiti):**
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
BROWSER_MODE=persistent npx @natchs/browser-mcp
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
v2.3.0 ile Chrome profili otomatik tespit edilir. Hiçbir yol belirtmeniz gerekmez. Windows/macOS/Linux hepsinde çalışır. Manuel yol belirtmek için:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
BROWSER_MODE=persistent BROWSER_USER_DATA_DIR=C:\Users\...\User Data\Default npx @natchs/browser-mcp
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
**Örnek — connect (mevcut Chrome'a bağlan):**
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
# Önce Chrome'u debug port ile aç:
|
|
68
|
+
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222
|
|
69
|
+
|
|
70
|
+
# Sonra ajanı bağla:
|
|
71
|
+
BROWSER_MODE=connect npx @natchs/browser-mcp
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
**MCP Client Config ile kullanım — her mod için ayrı profil:**
|
|
75
|
+
|
|
76
|
+
```json
|
|
77
|
+
{
|
|
78
|
+
"mcpServers": {
|
|
79
|
+
"browser-mcp-persistent": {
|
|
80
|
+
"command": "npx",
|
|
81
|
+
"args": ["@natchs/browser-mcp"],
|
|
82
|
+
"env": {
|
|
83
|
+
"BROWSER_MODE": "persistent"
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
"browser-mcp-fresh": {
|
|
87
|
+
"command": "npx",
|
|
88
|
+
"args": ["@natchs/browser-mcp"],
|
|
89
|
+
"env": {
|
|
90
|
+
"BROWSER_MODE": "fresh"
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
42
97
|
---
|
|
43
98
|
|
|
44
99
|
## Detaylı Özellikler
|
|
@@ -71,6 +126,14 @@ npx @natchs/browser-mcp
|
|
|
71
126
|
- **Observability**: Structured JSON logging, tool metrikleri (call count, süre, hata), LRU cache + TTL
|
|
72
127
|
- **Rate Limiting**: Token bucket, global + per-tool, yapılandırılabilir RPM
|
|
73
128
|
|
|
129
|
+
### Browser Profil Yönetimi (v2.3.0)
|
|
130
|
+
|
|
131
|
+
Ajan, 3 farklı browser modundan biriyle çalışır:
|
|
132
|
+
|
|
133
|
+
- **`fresh` (default):** Playwright'ın kendi Chromium'unu kullanır, her seferinde sıfır profil. Çerez, geçmiş, uzantı — hiçbiri taşınmaz.
|
|
134
|
+
- **`persistent`:** Gerçek Chrome profilinizi kullanır. Oturum açtığınız tüm sitelere (Gmail, GitHub, ChatGPT, kurumsal VPN) ajan da "sizmiş gibi" erişir. v2.3.0 ile profil otomatik tespit edilir — `BROWSER_MODE=persistent` yazmanız yeterli.
|
|
135
|
+
- **`connect`:** Halihazırda `--remote-debugging-port` ile açılmış Chrome'unuza bağlanır. Mevcut sekmeleri ve oturumları ajanla paylaşırsınız.
|
|
136
|
+
|
|
74
137
|
### Ne Yapamaz? (Mevcut Sınırlamalar)
|
|
75
138
|
|
|
76
139
|
- **Cloudflare/anti-bot korumalı siteler**: Challenge sayfalarını geçemez, manuel çözüm gerekir
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@natchs/browser-mcp",
|
|
3
|
-
"version": "2.3.
|
|
4
|
-
"description": "MCP server for browser automation — reverse engineering, web scraping, network interception, HAR export, WebSocket capture, SSRF-safe download tool. AI agent controlled via Model Context Protocol.",
|
|
3
|
+
"version": "2.3.1",
|
|
4
|
+
"description": "MCP server for browser automation — reverse engineering, web scraping, network interception, HAR export, WebSocket capture, SSRF-safe download tool. Three browser modes: fresh (isolated), persistent (your Chrome profile with auto-detect), connect (existing browser). AI agent controlled via Model Context Protocol.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|