Skip to content

Commit ee881f8

Browse files
FineComputer14451FineComputer14451
authored
Merge pull request #17 from FineComputer14451/feat/grok-build-connect
feat: Grok Build Connect (Termux + desktop MCP)
2 parents 7bbd04b + 6ee0388 commit ee881f8

26 files changed

Lines changed: 1415 additions & 2 deletions

‎.grok-plugin/marketplace.json‎

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -463,8 +463,37 @@
463463
"path": "./plugins/grokhunter-termux-connect"
464464
},
465465
"homepage": "https://finecomputer14451.github.io/GrokHunter/",
466-
"keywords": ["grokhunter termux connect", "grokhunter termux mcp", "termux connect grokhunter"],
467-
"domains": ["finecomputer14451.github.io"]
466+
"keywords": [
467+
"grokhunter termux connect",
468+
"grokhunter termux mcp",
469+
"termux connect grokhunter"
470+
],
471+
"domains": [
472+
"finecomputer14451.github.io"
473+
]
474+
},
475+
{
476+
"name": "grokhunter-grok-build-connect",
477+
"description": "Bridge Grok Bot to local Grok Build (grok CLI) via HTTP MCP + tunnel. Termux and desktop.",
478+
"category": "development",
479+
"version": "1.0.0",
480+
"author": {
481+
"name": "FineComputer14451",
482+
"url": "https://github.com/FineComputer14451/GrokHunter"
483+
},
484+
"source": {
485+
"type": "local",
486+
"path": "./plugins/grokhunter-grok-build-connect"
487+
},
488+
"homepage": "https://finecomputer14451.github.io/GrokHunter/",
489+
"keywords": [
490+
"grokhunter grok build connect",
491+
"grok build mcp",
492+
"grok connect"
493+
],
494+
"domains": [
495+
"finecomputer14451.github.io"
496+
]
468497
}
469498
]
470499
}

‎.grok-plugin/plugin-index.json‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -748,6 +748,30 @@
748748
}
749749
],
750750
"version": "1.0.0"
751+
},
752+
{
753+
"agents": [],
754+
"commands": [
755+
{
756+
"description": "Install Grok Build Connect MCP on Termux or desktop",
757+
"name": "grok-build-connect-install"
758+
},
759+
{
760+
"description": "Tunnel Grok Build Connect MCP with Cloudflare",
761+
"name": "grok-build-connect-tunnel"
762+
}
763+
],
764+
"hooks": [],
765+
"lspServers": [],
766+
"mcpServers": [],
767+
"name": "grokhunter-grok-build-connect",
768+
"skills": [
769+
{
770+
"description": "Bridge Grok Bot to the local Grok Build (grok) CLI via authenticated HTTP MCP + Cloudflare/ngrok tunnel on Termux or desktop.",
771+
"name": "grok-build-connect"
772+
}
773+
],
774+
"version": "1.0.0"
751775
}
752776
]
753777
}

‎docs/MARKETPLACE.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ grok plugin install grokhunter-ci --trust
5656
| `grokhunter-desktop` | GrokHunter X11 desktop — grokhunter binds, nh-x11, bwrap black-screen triage (rootless). |
5757
| `grokhunter-overlay` | GrokHunter overlay cache — install.sh --overlay-only, MODULES_VERSION, PATH wrappers. |
5858
| `grokhunter-tookie` | Authorized public username OSINT with Tookie-OSINT (Sherlock-class). Scoped GrokHunter mod… |
59+
| `grokhunter-grok-build-connect` | Bridge Grok Bot ↔ local `grok` CLI via HTTP MCP + tunnel (Termux + desktop). |
5960
| `grokhunter-termux-connect` | Bridge Grok Bot ↔ Termux via HTTP MCP + tunnel (not native Local Computer). |
6061
| `grokhunter-full` | Complete GrokHunter Grok Build pack — core, Coding Team, all lab specialists, desktop, ove… |
6162

@@ -88,6 +89,7 @@ Native Grok Bot Local Computer is Mac/Windows only. To drive GrokHunter on Termu
8889

8990
```bash
9091
grok plugin install grokhunter-termux-connect --trust
92+
grok plugin install grokhunter-grok-build-connect --trust
9193
bash ~/.… # see plugin README / skill termux-connect
9294
```
9395

‎plugins/grokhunter-grok-build-connect/.cursor-plugin/plugin.json‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
{
2+
"name": "grokhunter-grok-build-connect",
3+
"version": "1.0.0",
4+
"description": "Bridge Grok Bot to local Grok Build (grok CLI) via authenticated HTTP MCP + tunnel. Termux and desktop. Not affiliated with xAI / OffSec / Termux / jorexdeveloper.",
5+
"author": {
6+
"name": "FineComputer14451",
7+
"url": "https://github.com/FineComputer14451/GrokHunter"
8+
},
9+
"homepage": "https://finecomputer14451.github.io/GrokHunter/",
10+
"repository": "https://github.com/FineComputer14451/GrokHunter",
11+
"license": "MIT",
12+
"keywords": [
13+
"grokhunter grok build connect",
14+
"grok build mcp",
15+
"grok connect"
16+
],
17+
"logo": "assets/logo.png",
18+
"displayName": "GrokHunter Grok Build Connect",
19+
"category": "developer-tools",
20+
"skills": "./skills/",
21+
"commands": "./commands/"
22+
}

‎plugins/grokhunter-grok-build-connect/.grok-plugin/plugin.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{
2+
"name": "grokhunter-grok-build-connect",
3+
"version": "1.0.0",
4+
"description": "Bridge Grok Bot to local Grok Build (grok CLI) via authenticated HTTP MCP + tunnel. Termux and desktop. Not affiliated with xAI / OffSec / Termux / jorexdeveloper.",
5+
"author": {
6+
"name": "FineComputer14451",
7+
"url": "https://github.com/FineComputer14451/GrokHunter"
8+
},
9+
"homepage": "https://finecomputer14451.github.io/GrokHunter/",
10+
"repository": "https://github.com/FineComputer14451/GrokHunter",
11+
"license": "MIT",
12+
"keywords": [
13+
"grokhunter grok build connect",
14+
"grok build mcp",
15+
"grok connect"
16+
],
17+
"logo": "assets/logo.png"
18+
}

‎plugins/grokhunter-grok-build-connect/LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 GrokHunter contributors
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎plugins/grokhunter-grok-build-connect/README.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# grokhunter-grok-build-connect
2+
3+
Bridge **Grok Bot → local Grok Build (`grok` CLI)** via authenticated HTTP MCP + tunnel.
4+
Works on **Termux and desktop**. Not affiliated with xAI / OffSec / Termux / jorexdeveloper.
5+
6+
## Why
7+
8+
Grok Bot’s native Local Computer is Mac/Windows. This plugin exposes your installed
9+
`grok` CLI (phone or desktop) over HTTPS MCP so the Bot can call version/plugins/ask tools.
10+
11+
## Quick start
12+
13+
```bash
14+
curl -fsSL https://raw.githubusercontent.com/FineComputer14451/GrokHunter/main/skills/grok-build-connect/scripts/bootstrap.sh | bash -s -- --tunnel
15+
```
16+
17+
Default port **8766** (keeps Termux Connect on 8765 free).
18+
19+
## Security
20+
21+
- Listens on `127.0.0.1` only
22+
- Bearer token required (min 24 chars)
23+
- Path jail: `$HOME` (+ `$PREFIX` on Termux)
24+
- Never commit `~/.grokhunter-grok-build-connect/token`
25+
26+
## Credits
27+
28+
See [CREDITS.md](https://github.com/FineComputer14451/GrokHunter/blob/main/CREDITS.md).

‎plugins/grokhunter-grok-build-connect/assets/logo.png‎

11.7 KB
Loading

‎plugins/grokhunter-grok-build-connect/commands/grok-build-connect-install.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
description: Install Grok Build Connect MCP on Termux or desktop
3+
---
4+
Run:
5+
6+
```bash
7+
bash skills/grok-build-connect/scripts/install.sh
8+
~/.grokhunter-grok-build-connect/start.sh
9+
```
10+
11+
Do **not** print `~/.grokhunter-grok-build-connect/token`. Next: `/grok-build-connect-tunnel`.

‎plugins/grokhunter-grok-build-connect/commands/grok-build-connect-tunnel.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
description: Tunnel Grok Build Connect MCP with Cloudflare
3+
---
4+
```bash
5+
bash skills/grok-build-connect/scripts/tunnel-cloudflare.sh
6+
```
7+
8+
Copy `https://….trycloudflare.com`, append `/mcp`. Bearer from `~/.grokhunter-grok-build-connect/token`.

0 commit comments

Comments
 (0)