Skip to main content
Glama

Jenny Tools โ€“ MCP 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

Related MCP server: WinPilot Computer Use MCP

๐Ÿ—๏ธ 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    Related MCP Connectors

    Related MCP Servers