gooners

module
v0.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 17, 2026 License: MIT

README ¶

gooners

MCP (Model Context Protocol) servers, AI tools, and agent skills built on go-faster technologies.

Tools

Tool Description
ssh-mcp MCP server exposing SSH, SFTP, and other operations as agent tools (Docker support included)
grafana-dashboard-mcp MCP server for building, verifying, and exporting Grafana dashboards using the Grafana Foundation SDK (Docker support included)
alertmanager-mcp MCP server for Alertmanager alerts, silences, receivers, and cluster status, plus PromQL validate/evaluate tools (Docker support included)
opencode-handoff-mcp MCP server for delegating coding tasks to opencode agents and monitoring their sessions
gitlab-mcp MCP server for GitLab issues, merge requests, releases, and repository browsing; every tool takes a project, so no git checkout is required
mcpgateway MCP proxy that aggregates tools from multiple upstream MCP servers (stdio, streamable-http, sse) with per-upstream prefixes, allow/deny globs, description trim, output redaction, and optional per-upstream host/path routes

Prompts

The MCP servers expose predefined prompts that can be invoked by AI agents:

Server Prompt Description
ssh-mcp troubleshoot-ssh Provides instructions on how to use SSH tools to debug a remote machine
grafana-dashboard-mcp design-dashboard Guides the agent through metric discovery, RED/USE dashboard design, query verification, and export

Resources

The MCP servers expose read-only resources for state that is useful to inspect without invoking a mutating tool:

Server Resource Description
grafana-dashboard-mcp grafana-dashboard://sessions Lists active dashboard builder sessions
grafana-dashboard-mcp grafana-dashboard://sessions/{dashboard_id}/state Returns editable session state plus computed layout
grafana-dashboard-mcp grafana-dashboard://sessions/{dashboard_id}/export{?version} Returns compiled dashboard JSON; optional version is v1 or v2
gitlab-mcp gitlab:///{project} Metadata of the project passed as -project; listed only when one is configured
gitlab-mcp gitlab:///{project}/-/issues/{iid} One issue, as issue_view returns it
gitlab-mcp gitlab:///{project}/-/merge_requests/{iid} One merge request, as mr_view returns it
gitlab-mcp gitlab:///{project}/-/releases/{tag} One release, as release_view returns it
gitlab-mcp gitlab:///{project}/-/blob/{ref}/{path} A repository file's contents at a ref

Skills

Agent skills (slash commands) that can be installed into AI coding assistants.

Skill Description
alert-writing Create, review, rewrite, or tune monitoring alerts, alert rules, SLO/burn-rate alerts, routing, and runbooks
jx Correct, high-performance JSON encoding/decoding with github.com/go-faster/jx
golang-refactor-tools Mechanical Go rewrites with gofmt -r, gopatch, rsc.io/rf, and eg
linux-hardening-skill Harden Linux servers, Docker/containerd, and Kubernetes workloads on public IPs — host OS, SSH, network, container runtime, supply chain, and K8s security

🚀 Installing skills

Install with skills.sh CLI (works with any Agent Skills-compatible tool):

npx skills add https://github.com/go-faster/gooners --all
# or a single skill:
npx skills add https://github.com/go-faster/gooners --skill jx
Claude Code
/plugin marketplace add go-faster/gooners

Or clone and install manually:

git clone https://github.com/go-faster/gooners.git ~/.claude/skills/gooners
OpenCode
git clone https://github.com/go-faster/gooners.git ~/.agents/skills/gooners

OpenCode auto-discovers skills from .agents/skills/, .opencode/skills/, and .claude/skills/.

Cursor
git clone https://github.com/go-faster/gooners.git ~/.cursor/skills/gooners

Cursor auto-discovers skills from .agents/skills/ and .cursor/skills/.

Codex (OpenAI)
git clone https://github.com/go-faster/gooners.git ~/.agents/skills/gooners

Codex auto-discovers skills from ~/.agents/skills/ and .agents/skills/.

Directories ¶

Path Synopsis
cmd
alertmanager-mcp command
Package main is the entrypoint for the alertmanager-mcp MCP server.
Package main is the entrypoint for the alertmanager-mcp MCP server.
gitlab-mcp command
Package main is the entrypoint for the gitlab-mcp MCP server.
Package main is the entrypoint for the gitlab-mcp MCP server.
grafana-dashboard-mcp command
Package main is the entrypoint for the grafana-dashboard-mcp MCP server.
Package main is the entrypoint for the grafana-dashboard-mcp MCP server.
mcpgateway command
Package main is the entrypoint for the mcpgateway MCP proxy.
Package main is the entrypoint for the mcpgateway MCP proxy.
opencode-handoff-mcp command
Package main is the entrypoint for the opencode-handoff-mcp MCP server.
Package main is the entrypoint for the opencode-handoff-mcp MCP server.
ssh-mcp command
Package main is the entrypoint for the ssh-mcp MCP server.
Package main is the entrypoint for the ssh-mcp MCP server.
internal
cmdutil
Package cmdutil provides shared command-line helpers for MCP binaries.
Package cmdutil provides shared command-line helpers for MCP binaries.
e2e
Package e2e provides shared helpers and end-to-end tests for the ssh-mcp server using testcontainers and the official MCP Go SDK client over in-memory transport.
Package e2e provides shared helpers and end-to-end tests for the ssh-mcp server using testcontainers and the official MCP Go SDK client over in-memory transport.
effect
Package effect provides the filesystem and HTTP effect providers through which every agent-reachable side effect must pass.
Package effect provides the filesystem and HTTP effect providers through which every agent-reachable side effect must pass.
gateway
Package gateway implements an MCP gateway that proxies multiple upstream MCP servers.
Package gateway implements an MCP gateway that proxies multiple upstream MCP servers.
gateway/middleware
Package middleware provides tool call middleware for the gateway.
Package middleware provides tool call middleware for the gateway.
gateway/router
Package router provides host and path based request routing.
Package router provides host and path based request routing.
gateway/transport
Package gatewaytransport builds mcp.Transport implementations from gateway config.
Package gatewaytransport builds mcp.Transport implementations from gateway config.
mcputil
Package mcputil provides shared MCP server initialization and event logic.
Package mcputil provides shared MCP server initialization and event logic.
session
Package session provides SSH configuration parsing, host key handling, authentication methods, and connection pooling for remote machine access.
Package session provides SSH configuration parsing, host key handling, authentication methods, and connection pooling for remote machine access.
sshutil
Package sshutil provides helpers for running commands over SSH connections.
Package sshutil provides helpers for running commands over SSH connections.
tools/alertmanager
Package alertmanager registers MCP tools for reading Alertmanager alerts, silences, receivers and status, plus a guarded silence-creation workflow and PromQL validate/evaluate helpers.
Package alertmanager registers MCP tools for reading Alertmanager alerts, silences, receivers and status, plus a guarded silence-creation workflow and PromQL validate/evaluate helpers.
tools/core
Package core registers the core MCP tools for opening SSH sessions and running commands.
Package core registers the core MCP tools for opening SSH sessions and running commands.
tools/disk
Package disk registers MCP tools for disk and filesystem inspection (lsblk).
Package disk registers MCP tools for disk and filesystem inspection (lsblk).
tools/fs
Package fs registers MCP tools for remote file operations (ls, cat, upload, download, grep).
Package fs registers MCP tools for remote file operations (ls, cat, upload, download, grep).
tools/gitlab
Package gitlab registers MCP tools for GitLab issues, merge requests, releases and repository browsing.
Package gitlab registers MCP tools for GitLab issues, merge requests, releases and repository browsing.
tools/grafana
Package grafana registers MCP tools to build, verify, and save Grafana dashboards.
Package grafana registers MCP tools to build, verify, and save Grafana dashboards.
tools/mcputil
Package mcputil provides a generic helper for registering MCP tools with proper annotations (ReadOnlyHint, DestructiveHint) and defines structured result types used across tool packages to enable automatic InputSchema/OutputSchema inference while maintaining exact backwards-compatibility with JSON schemas.
Package mcputil provides a generic helper for registering MCP tools with proper annotations (ReadOnlyHint, DestructiveHint) and defines structured result types used across tool packages to enable automatic InputSchema/OutputSchema inference while maintaining exact backwards-compatibility with JSON schemas.
tools/opencode
Package opencode registers MCP tools that delegate work to an opencode server.
Package opencode registers MCP tools that delegate work to an opencode server.
tools/opencode/opencodeapi
Code generated by ogen, DO NOT EDIT.
Code generated by ogen, DO NOT EDIT.
tools/proc
Package proc registers MCP tools for process inspection and management (ps, kill).
Package proc registers MCP tools for process inspection and management (ps, kill).
tools/sysinfo
Package sysinfo registers MCP tools for system information (network, OS, users).
Package sysinfo registers MCP tools for system information (network, OS, users).
tools/systemd
Package systemd registers MCP tools for inspecting systemd units.
Package systemd registers MCP tools for inspecting systemd units.
tunnel
Package tunnel provides tunneling listeners.
Package tunnel provides tunneling listeners.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL