Jenny Server

Server MCP (Model Context Protocol) lokal yang membungkus tool Python untuk AI Agent, memungkinkan interaksi langsung dengan Windows — browser, clipboard, file, GitHub, Roblox Studio, screenshot, OCR, dan banyak lagi.

Dibangun dengan arsitektur stdio MCP + privileged approval system, cocok dipasangkan dengan Hermes Agent, Claude Code, atau MCP client lain.

✨ Fitur

Modul	Fungsi
🌐 Brave Browser	Buka URL, klik, isi form, screenshot, baca halaman via CDP
🔍 Brave Search	Cari web + berita dengan parameter negara/bahasa
🌍 Web Tools	Baca halaman, screenshot, click-and-read via browser headless
📁 Archive	Baca & ekstrak ZIP/RAR
📄 Document Reader	Baca DOCX, XLSX, PDF
🖼️ OCR	Baca teks dari gambar via Tesseract
🎬 Video Reader	Ekstrak frame, audio, transkripsi dari video
📋 Clipboard	Baca, tulis, bersihkan clipboard Windows
⬇️ Download	Download file dari URL
📸 Screenshot	Screenshot seluruh desktop
🎮 Roblox Studio	Baca hierarchy, inspect/edit properti, visual inspect via bridge plugin
🎨 ComfyUI	Generate gambar via ComfyUI lokal
🐙 GitHub CLI	Cek auth, repo list/view/clone, SSH key management
🔐 Credential Diagnostics	Periksa token & SSH key tanpa mengekspos isinya
📊 Market Watch	Scan XAUUSD/GBPUSD/EURUSD M5 — liquidity sweep, S&R, R:R, session filter
💰 MT5 Trading	Account info, positions, pending orders, trade history — market order, modify SL/TP, close, pending order, cancel

🏗️ Arsitektur

AI Agent (Hermes, Claude Code, dll)
  │
  └── MCP stdio
        │
        └── jenny_mcp_server.py
              │
              ├── approval_store.py    ← sistem approval manual
              ├── jenny_privileged_tools.py  ← tools berisiko (approval-only)
              │
              └── C:\AI-Agent\tools\   ← modul Python eksternal
                    ├── cli_*.py
                    ├── brave_browser_tool.py
                    ├── web_search_tool.py
                    └── ...

🚀 Instalasi

# 1. Install MCP SDK
py -m pip install "mcp[cli]"

# 2. Clone/extract ke C:\AI-Agent\mcp
# 3. Pastikan tools ada di C:\AI-Agent\tools

# 4. Tes server
cd C:\AI-Agent\mcp
py jenny_mcp_server.py

# 5. Tes interaktif dengan MCP Inspector
npx -y @modelcontextprotocol/inspector ^
  py C:\AI-Agent\mcp\jenny_mcp_server.py

🔌 Konfigurasi Hermes Agent

Masukkan ini ke ~/.hermes/config.yaml:

mcp_servers:
  jenny_tools:
    command: "py"
    args:
      - "C:\\AI-Agent\\mcp\\jenny_mcp_server.py"
    env:
      JENNY_TOOLS_DIR: "C:\\AI-Agent\\tools"
      JENNY_MCP_LOG_DIR: "C:\\AI-Agent\\logs"
      JENNY_APPROVAL_DIR: "C:\\AI-Agent\\approvals"
      JENNY_SHELL_ROOT: "C:\\AI-Agent"
    enabled: true
    timeout: 900

Lalu restart Hermes atau jalankan /reload-mcp.

🛡️ Sistem Keamanan

• Approval manual — tindakan berisiko (hapus file, edit script, push GitHub) memerlukan persetujuan manual via approve_mcp_action.py
• Tanpa hardcoded credential — semua API key/token dibaca dari environment variable
• Executable allowlist — shell execution hanya untuk binary yang diizinkan
• Parallel calls disabled — karena banyak tool mengontrol GUI/clipboard/browser

🎮 Roblox Studio Integration

Membutuhkan bridge plugin yang berjalan di Roblox Studio:

cd C:\AI-Agent\tools
py cli_roblox_studio.py serve

Plugin tersedia di: C:\\Users\\<user>\\AppData\\Local\\Roblox\\Plugins\\JennyRobloxBridge.rbxmx

💰 MT5 Trading Integration

Berinteraksi dengan MetaTrader 5 broker (Exness) untuk data akun dan eksekusi trading.

Read-Only Tools (tanpa konfirmasi)

Tool MCP	Deskripsi
mt5_account	Balance, equity, margin, leverage, profit
mt5_positions	Semua posisi terbuka — ticket, symbol, volume, profit, SL/TP
mt5_pending_orders	Daftar pending order buy/sell limit & stop
mt5_trade_history	Riwayat transaksi N hari terakhir

Privileged Tools (butuh approval manual)

Semua eksekusi trading wajib disetujui via approve_mcp_action.py:

Tool MCP	Deskripsi
mt5_order	Market buy/sell — auto hitung volume step, SL/TP
mt5_modify	Ubah SL/TP posisi terbuka
mt5_close	Tutup posisi (partial/full close)
mt5_pending	Buat pending order (buy_limit, sell_limit, buy_stop, sell_stop)
mt5_cancel	Batalkan pending order

Persyaratan

• MetaTrader 5 harus terinstall dan login ke akun demo/real
• Python package MetaTrader5 terinstall di MCP server Python
• Symbol Exness menggunakan suffix m (XAUUSDm, EURUSDm, GBPUSDm) — otomatis diresolve

# Install MT5 package
py -m pip install MetaTrader5

🔧 Environment Variables

Variable	Default	Deskripsi
JENNY_TOOLS_DIR	C:\AI-Agent\tools	Direktori modul tool Python
JENNY_MCP_LOG_DIR	C:\AI-Agent\logs	Direktori log server
JENNY_APPROVAL_DIR	C:\AI-Agent\approvals	Direktori ticket approval
JENNY_SHELL_ROOT	C:\AI-Agent	Root untuk eksekusi shell
ROBLOX_OPEN_CLOUD_API_KEY	—	API key untuk publish Roblox place

Catatan: MT5 trading tools tidak memerlukan environment variable tambahan — koneksi MT5 menggunakan akun yang sudah login di terminal MT5.

📋 Tool Prefix

Semua tool diregistrasi dengan prefix mcp_jenny_tools_:

Tool MCP	Fungsi
mcp_jenny_tools_system_status	Status semua modul
mcp_jenny_tools_web_search	Cari web
mcp_jenny_tools_brave_open	Buka URL di Brave
mcp_jenny_tools_roblox_hierarchy	Baca hierarchy Studio
mcp_jenny_tools_comfy_generate	Generate gambar
mcp_jenny_tools_document_read	Baca DOCX/XLSX/PDF
mcp_jenny_tools_market_watch	Scan M5 market — liquidity sweep entry
mcp_jenny_tools_mt5_account	Info akun MT5
mcp_jenny_tools_mt5_positions	Posisi terbuka
mcp_jenny_tools_mt5_order	Market buy/sell (privileged)
mcp_jenny_tools_mt5_modify	Ubah SL/TP (privileged)
mcp_jenny_tools_mt5_close	Tutup posisi (privileged)
...dan 35+ tool lainnya

📁 Struktur Folder

C:\AI-Agent\mcp\
├── jenny_mcp_server.py          ← Main MCP server
├── jenny_mcp_common.py          ← Utility & availability check
├── jenny_privileged_tools.py    ← High-risk tools
├── approval_store.py            ← Approval ticket system
├── approve_mcp_action.py        ← CLI approval tool
├── tools/
│   ├── core.py                  ← Shared response helpers
│   ├── mt5_data_tool.py         ← Market data (tick, OHLC, bundle)
│   ├── mt5_trading_tool.py      ← Trading execution (account, positions, orders)
│   └── ...                      ← Other tool modules
├── README_SETUP.md              ← Setup instructions (original)
├── hermes_config_snippet.yaml   ← Contoh config YAML
├── install_mcp.ps1              ← Instalasi script
├── requirements.txt             ← Dependency (mcp[cli])
└── .gitignore

📜 Lisensi

MIT — Silakan gunakan, modifikasi, dan distribusikan.

---

Dibuat dengan ☕ oleh RhaDar12