jaringan-mcp

MCP (Model Context Protocol) server for the Jaringan (JRG) protocol. Lets AI agents fetch, inspect, search, and manage Jaringan pages through structured tool calls.

Install

npm install jaringan-mcp

Usage

Standalone

npm install jaringan-mcp

# Connect to a JRG server on localhost:7080
npx jaringan-mcp --jrg-port 7080

# Read from local .jrg files instead
npx jaringan-mcp --file-root ~/wiki

# Custom host/port with browser binary
npx jaringan-mcp --jrg-host 10.0.0.1 --jrg-port 7070 --browser /usr/bin/jaringan-browser

With Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  jaringan:
    command: "npx"
    args: ["-y", "jaringan-mcp", "--jrg-port", "7080"]

Or for local file access:

mcp_servers:
  jaringan:
    command: "npx"
    args: ["-y", "jaringan-mcp", "--file-root", "/home/user/wiki"]

Restart Hermes to auto-discover the tools.

With Claude Code / Copilot / Any MCP Host

{
  "mcpServers": {
    "jaringan": {
      "command": "npx",
      "args": ["-y", "jaringan-mcp", "--jrg-port", "7080"]
    }
  }
}

Tools

Tool	Description
jrg_fetch	Fetch a JRG page → structured content (title, body, tags, links)
jrg_fetch_raw	Fetch raw JRG protocol response (status, headers, body)
jrg_inspect	Inspect a page → JSON manifest of interactive elements
jrg_search	Search local .jrg pages under a root directory
jrg_auth_list	List all stored Jaringan authentication tokens
jrg_view	Render a page as formatted plain text
jrg_list	List all available Jaringan pages (slug + title)

Options

Flag	Default	Description
--jrg-host	localhost	JRG TCP server hostname
--jrg-port	7070	JRG TCP server port
--file-root	—	Read from local .jrg files (instead of TCP)
--browser	jaringan-browser	Path to jaringan-browser binary
--tcp-timeout	5000	TCP connection timeout in ms

Architecture

AI Agent (Hermes, Claude Code, etc.)
        │
        │ MCP protocol (JSON-RPC over stdio)
        ▼
┌─────────────────────────────┐
│     jaringan-mcp server     │
│                             │
│  ┌───────────────────────┐  │
│  │  jrg-client (lib)     │──│── TCP → JRG server (port 7070/7080)
│  └───────────────────────┘  │
│  ┌───────────────────────┐  │
│  │  jaringan-browser CLI │──│── inspect / search / auth
│  └───────────────────────┘  │
│  ┌───────────────────────┐  │
│  │  Local file reader    │──│── .jrg files on disk
│  └───────────────────────┘  │
└─────────────────────────────┘

Publishing

npm run build
npm publish --access public

License

MIT