diff --git a/examples/mcp/README.md b/examples/mcp/README.md index cc4a8b03e..ee8439efd 100644 --- a/examples/mcp/README.md +++ b/examples/mcp/README.md @@ -1,5 +1,32 @@ # MCP Server Examples +## Install (SHA-256) + +Pin GitHub Release **v0.6.0** and verify `SHA256SUMS`. Website `install.sh` / `install.ps1` abort on mismatch. + +https://github.com/LinespottingOrg/GrokBuildRemote-Agents/releases/tag/v0.6.0 +https://github.com/LinespottingOrg/GrokBuildRemote-Agents/blob/main/docs/PINNED-INSTALL.md + +``` +96cef605d3e030ccef99d27ea6240e0d3b668dd045e6b5b9e585c9fd03c6ef23 gbr-agent-darwin-amd64 +de7e065ef2cf6877b3b2cd04679a67b627f876337f529247e236204543e4062c gbr-agent-darwin-arm64 +a50a5c41993e6531a3b477eb409ccc845212bf541384dc803061c80657f86719 gbr-agent-linux-amd64 +5bfd22c7110234942c4c02ff8154b836d0af45a9422c178a4f52010187d40061 gbr-agent-linux-arm64 +f773b89fd31310172b756e0593e0f3b2382b0a3440af2a7d0a8b3073b0c23e27 gbr-agent-windows-amd64.exe +8fb9efcbc7e2ac91c11964944bf0f45e31bb23f4356d9dcb4b305d7cb9b0fe8c gbr-agent-windows-arm64.exe +``` + +```bash +VER=v0.6.0 +BASE=https://github.com/LinespottingOrg/GrokBuildRemote-Agents/releases/download/$VER +# swap darwin-arm64 for your OS/arch +curl -fsSL -o gbr-agent-darwin-arm64 "$BASE/gbr-agent-darwin-arm64" +curl -fsSL -o SHA256SUMS "$BASE/SHA256SUMS" +shasum -a 256 -c SHA256SUMS --ignore-missing +gbr-agent pair && gbr-agent run +``` + + Examples demonstrating the MCP Server v2 features per MCP Protocol Version 2025-11-25. ## Features Demonstrated @@ -139,3 +166,10 @@ Pair a phone running [Build Remote Agent](https://grokbuildremote.com/) to a Pra ```bash python gbr_pair.py ``` + +## What the phone sees + +**Terminal windows** on this PC (machine-wide mailbox). Not headless OpenCode / CodeNomad sidecar / Electron. `:8788` in a sidecar is Bot API JSON, not a transcript. + +https://github.com/LinespottingOrg/GrokBuildRemote-Agents/blob/main/docs/WHAT-THE-PHONE-SEES.md +https://grokbuildremote.com/integrations.html diff --git a/examples/mcp/gbr_pair.py b/examples/mcp/gbr_pair.py index 7f8774e8b..55304f822 100644 --- a/examples/mcp/gbr_pair.py +++ b/examples/mcp/gbr_pair.py @@ -22,6 +22,33 @@ https://grokbuildremote.com/ from praisonaiagents import Agent, MCP # Clone https://github.com/LinespottingOrg/GrokBuildRemote-Agents.git + +## Install (SHA-256) + +Pin GitHub Release **v0.6.0** and verify `SHA256SUMS`. Website `install.sh` / `install.ps1` abort on mismatch. + +https://github.com/LinespottingOrg/GrokBuildRemote-Agents/releases/tag/v0.6.0 +https://github.com/LinespottingOrg/GrokBuildRemote-Agents/blob/main/docs/PINNED-INSTALL.md + +``` +96cef605d3e030ccef99d27ea6240e0d3b668dd045e6b5b9e585c9fd03c6ef23 gbr-agent-darwin-amd64 +de7e065ef2cf6877b3b2cd04679a67b627f876337f529247e236204543e4062c gbr-agent-darwin-arm64 +a50a5c41993e6531a3b477eb409ccc845212bf541384dc803061c80657f86719 gbr-agent-linux-amd64 +5bfd22c7110234942c4c02ff8154b836d0af45a9422c178a4f52010187d40061 gbr-agent-linux-arm64 +f773b89fd31310172b756e0593e0f3b2382b0a3440af2a7d0a8b3073b0c23e27 gbr-agent-windows-amd64.exe +8fb9efcbc7e2ac91c11964944bf0f45e31bb23f4356d9dcb4b305d7cb9b0fe8c gbr-agent-windows-arm64.exe +``` + +```bash +VER=v0.6.0 +BASE=https://github.com/LinespottingOrg/GrokBuildRemote-Agents/releases/download/$VER +# swap darwin-arm64 for your OS/arch +curl -fsSL -o gbr-agent-darwin-arm64 "$BASE/gbr-agent-darwin-arm64" +curl -fsSL -o SHA256SUMS "$BASE/SHA256SUMS" +shasum -a 256 -c SHA256SUMS --ignore-missing +gbr-agent pair && gbr-agent run +``` + # then point args at mcp/gbr-mcp/bin/gbr-mcp.js (loopback stdio). gbr = Agent( instructions=( @@ -40,3 +67,10 @@ if __name__ == "__main__": gbr.start( "Check Build Remote Agent health on 127.0.0.1:8788 and list sessions." ) + +## What the phone sees + +**Terminal windows** on this PC (machine-wide mailbox). Not headless OpenCode / CodeNomad sidecar / Electron. `:8788` in a sidecar is Bot API JSON, not a transcript. + +https://github.com/LinespottingOrg/GrokBuildRemote-Agents/blob/main/docs/WHAT-THE-PHONE-SEES.md +https://grokbuildremote.com/integrations.html