Skip to content

Commit 76e15b1

Browse files
docs(readme): collapsible accordion sections for all 115 cartridges (#86)
## Summary Replace the brief 9-bullet Features list with a **Scope** section containing 14 collapsible (\`<details>\`) accordions, one per cartridge domain. Each accordion is a table of cartridges in that domain with one-line descriptions sourced from each cartridge's own \`cartridge.json\`. ## Why - The project's main differentiator — \"115 cartridges across every major DevOps + AI domain\" — was getting compressed to a 9-line bullet list. Readers couldn't actually browse the surface area. - Glama, npm, GitHub, JSR all render \`<details>\` blocks as accordions out of the box. No platform-specific magic. - Cmd-F on the rendered page hits every cartridge name and description even when collapsed. ## What's in the diff - Top section (badges, intro, install) **unchanged**. - New **Scope** section with 14 accordion categories: 1. Git forges &amp; code hosting (4) 2. Cloud platforms (10) 3. Databases (12) 4. Containers, deploy &amp; integrity (5) 5. CI/CD &amp; observability (8) 6. Communications &amp; messaging (6) 7. Productivity &amp; knowledge (10) 8. ML, AI &amp; coordination (8) 9. Browser &amp; web automation (2) 10. Code intelligence &amp; research (5) 11. Developer tooling — LSP/DAP/BSP, languages, registries (14) 12. Security &amp; secrets (7) 13. Infrastructure-as-code, config &amp; proof (7) 14. Hyperpolymath-native admin &amp; ecosystem (13) - New **Bridge-level tools (41 exposed)** subsection — explains which cartridges have explicit \`boj_<domain>_<verb>\` tools vs. which are reached via \`boj_cartridge_invoke\`. - \`BOJ_TOOL_SCOPE\` env var documented for narrowing the advertised tool surface. Local-coord-mcp, Glama AAA posture, and License sections retained as-is. ## What this doesn't change - The Glama-rendered **Tools list** at the top of the project page (its own widget driven by MCP \`tools/list\`) — that's a flat alphabetical list with no grouping you can control. The accordions help on the README portion *below* it. - No tool definitions, schemas, or runtime behavior changed. Docs-only. ## Sequencing This PR is independent of #84 (release/0.4.7) and #85 (Scorecard + CITATION.cff). If #84 merges first, this rebases trivially — the Install section it touches is at a different region than the accordions. ## Test plan - [ ] GitHub renders accordions (collapsed by default, click-to-expand) - [ ] Cmd-F hits cartridge names even when accordions are closed (browser-dependent) - [ ] No CI regressions (docs-only) - [ ] Glama re-scan picks up the new README on next sync 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 2b1304c commit 76e15b1

1 file changed

Lines changed: 257 additions & 11 deletions

File tree

README.md

Lines changed: 257 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -196,17 +196,263 @@ After install, ask the LLM: *"Use the `boj_health` tool."* You should get `{stat
196196

197197
Glama listing: <https://glama.ai/mcp/servers/hyperpolymath/boj-server>
198198

199-
## Features
200-
201-
- **GitHub/GitLab** — repos, issues, PRs, code search, mirroring (22 tools)
202-
- **Cloud** — Cloudflare (DNS, Workers, KV, R2, D1), Vercel (deployments, projects), Verpex (cPanel)
203-
- **Communication** — Gmail, Google Calendar
204-
- **Browser** — Firefox automation: navigate, click, type, screenshot, arbitrary JS (7 tools)
205-
- **Code Intelligence** — CodeSeeker hybrid search + graph RAG
206-
- **Research** — Semantic Scholar papers, citations, authors
207-
- **ML** — Hugging Face model / dataset / inference
208-
- **Local coordination** — `local-coord-mcp` (24 tools): multi-instance AI peer discovery, typed envelopes, claim/heartbeat/watchdog, quarantine + master/journeyman/apprentice supervision, track-record affinity, capability advertisement
209-
- **Cartridges** — 115 pluggable cartridges across Teranga / Shield / Ayo trust tiers
199+
## Scope
200+
201+
**115 cartridges**, organized across the domains below. Each cartridge is a formally verified Idris2 ABI + Zig FFI + Deno/JS adapter triple, reachable through a single MCP endpoint. Click any section to expand.
202+
203+
<details>
204+
<summary><b>🔧 Git forges &amp; code hosting</b> — 4 cartridges</summary>
205+
206+
| Cartridge | Description |
207+
|---|---|
208+
| `github-api-mcp` | GitHub REST API — repos, issues, PRs, search |
209+
| `gitlab-api-mcp` | GitLab REST API — projects, issues, MRs |
210+
| `github-actions-mcp` | GitHub Actions — workflows, runs, jobs, artifacts, secret rotation |
211+
| `git-mcp` | Multi-forge git operations (GitHub, GitLab, Gitea, Bitbucket) |
212+
213+
Bridge-level tools: `boj_github_*` (14), `boj_gitlab_*` (8) — 22 explicit tools. Auth via `GITHUB_TOKEN` / `GITLAB_TOKEN` env vars.
214+
215+
</details>
216+
217+
<details>
218+
<summary><b>☁️ Cloud platforms</b> — 10 cartridges</summary>
219+
220+
| Cartridge | Description |
221+
|---|---|
222+
| `cloud-mcp` | Multi-cloud session manager (AWS / GCP / Azure / DO / Vercel) |
223+
| `aws-mcp` | AWS gateway — session-based auth, per-region slots, throttle management |
224+
| `gcp-mcp` | GCP gateway — project-scoped auth, quota tracking, multi-service routing |
225+
| `cloudflare-mcp` | Cloudflare v4 — Workers, D1, KV, R2, DNS, zone settings, SSL/TLS |
226+
| `digitalocean-mcp` | DigitalOcean — droplets, volumes, domains, SSH keys, snapshots, databases |
227+
| `hetzner-mcp` | Hetzner Cloud — servers, volumes, firewalls, networks, snapshots, floating IPs |
228+
| `fly-mcp` | Fly.io Machines v1 — apps, machines, volumes, secrets, regions, IPs, certs |
229+
| `linode-mcp` | Linode/Akamai — instances, volumes, domains, NodeBalancers, StackScripts |
230+
| `railway-mcp` | Railway GraphQL v2 — projects, services, deployments, env, domains, logs |
231+
| `render-mcp` | Render REST v1 — services, deploys, env groups, custom domains, jobs |
232+
233+
Bridge-level tools: `boj_cloud_cloudflare`, `boj_cloud_vercel`, `boj_cloud_verpex`. Other providers reachable via `boj_cartridge_invoke`.
234+
235+
</details>
236+
237+
<details>
238+
<summary><b>🗄 Databases</b> — 12 cartridges</summary>
239+
240+
| Cartridge | Description |
241+
|---|---|
242+
| `database-mcp` | Universal SQL/NoSQL gateway across multiple engines |
243+
| `postgresql-mcp` | PostgreSQL — full transaction support, connection pooling, query lifecycle |
244+
| `mongodb-mcp` | MongoDB — collection-level CRUD, aggregation pipelines, sessions |
245+
| `redis-mcp` | Redis — KV, sorted sets, pub/sub, streams, Lua scripting |
246+
| `neo4j-mcp` | Neo4j — graph database query and write |
247+
| `clickhouse-mcp` | ClickHouse — columnar queries, bulk inserts, real-time analytics |
248+
| `duckdb-mcp` | DuckDB — in-process analytics over Parquet/CSV/JSON/Arrow |
249+
| `arango-mcp` | ArangoDB — AQL queries, multi-model documents, graph traversals |
250+
| `turso-mcp` | Turso libSQL — edge SQLite, multi-DB, embedded replica sync |
251+
| `supabase-mcp` | Supabase — Postgres, Auth, Storage, Edge Functions |
252+
| `neon-mcp` | Neon — serverless Postgres, branch management, query execution |
253+
| `verisimdb-mcp` | **VeriSimDB** — verified simulation database with formal drift detection |
254+
255+
</details>
256+
257+
<details>
258+
<summary><b>📦 Containers, deploy &amp; integrity</b> — 5 cartridges</summary>
259+
260+
| Cartridge | Description |
261+
|---|---|
262+
| `container-mcp` | Build / create / start / stop / remove via Podman or Docker |
263+
| `docker-hub-mcp` | Docker Hub — image search, repos, tag listing, manifests |
264+
| `k8s-mcp` | Kubernetes — namespace-scoped CRUD with lifecycle management |
265+
| `stapeln-mcp` | Stapeln stack manager — Chainguard-base composable container layers |
266+
| `vordr-mcp` | Vordr integrity monitor — BLAKE3 tamper-detection on container images |
267+
268+
</details>
269+
270+
<details>
271+
<summary><b>🔁 CI/CD &amp; observability</b> — 8 cartridges</summary>
272+
273+
| Cartridge | Description |
274+
|---|---|
275+
| `buildkite-mcp` | Buildkite — pipelines, builds, jobs, artifacts |
276+
| `circleci-mcp` | CircleCI — pipelines, workflows, jobs, artifacts |
277+
| `laminar-mcp` | Laminar — minimalist CI/CD pipeline management |
278+
| `hypatia-mcp` | **Hypatia** — neurosymbolic CI security/quality/compliance scanner |
279+
| `observe-mcp` | Unified observability — metrics, logs, traces |
280+
| `grafana-mcp` | Grafana — dashboards, panel queries, alert rules, annotations |
281+
| `prometheus-mcp` | Prometheus — PromQL instant + range queries, alerts, targets |
282+
| `sentry-mcp` | Sentry — issues, events, projects, releases, deployments |
283+
284+
</details>
285+
286+
<details>
287+
<summary><b>💬 Communications &amp; messaging</b> — 6 cartridges</summary>
288+
289+
| Cartridge | Description |
290+
|---|---|
291+
| `comms-mcp` | **Gmail + Google Calendar** — send, read, search, labels, events, free/busy |
292+
| `slack-mcp` | Slack — messages, channels, threads, search, users |
293+
| `discord-mcp` | Discord — messages, channel history, guilds, reactions |
294+
| `telegram-mcp` | Telegram Bot API — messages, chats, inline queries, updates |
295+
| `matrix-mcp` | Matrix — messages, room join/leave, history, membership |
296+
| `notifyhub-mcp` | Unified notify — Email, SMS, WhatsApp, Slack, Telegram, Discord |
297+
298+
Bridge-level tools: `boj_comms_gmail`, `boj_comms_calendar`.
299+
300+
</details>
301+
302+
<details>
303+
<summary><b>📚 Productivity &amp; knowledge</b> — 10 cartridges</summary>
304+
305+
| Cartridge | Description |
306+
|---|---|
307+
| `google-docs-mcp` | Docs — document retrieval, content, search, headings, comments |
308+
| `google-sheets-mcp` | Sheets — metadata, cell ranges, named ranges, sheet listing |
309+
| `notion-mcp` | Notion — pages, databases, blocks |
310+
| `obsidian-mcp` | Obsidian vault — note search, content, backlinks, tags, graph |
311+
| `linear-mcp` | Linear — issues, projects, cycles, labels |
312+
| `jira-mcp` | Jira — projects, issues, sprints, workflows |
313+
| `todoist-mcp` | Todoist — tasks, projects, completion, labels |
314+
| `airtable-mcp` | Airtable — bases, table schemas, record CRUD |
315+
| `zotero-mcp` | Zotero — library search, items, collections, tags |
316+
| `academic-workflow-mcp` | Academic workflow — Zotero integration, citations, paper review |
317+
318+
</details>
319+
320+
<details>
321+
<summary><b>🤖 ML, AI &amp; coordination</b> — 8 cartridges</summary>
322+
323+
| Cartridge | Description |
324+
|---|---|
325+
| `ml-mcp` | **Hugging Face** + others — search, model info, inference, spaces, datasets |
326+
| `claude-ai-mcp` | Anthropic Messages API — Claude models, token counting, multi-turn |
327+
| `claude-agents-power-mcp` | Specialized AI-agent management for dev teams |
328+
| `model-router-mcp` | Task classifier — recommends opus/sonnet/haiku per task |
329+
| `echidna-llm-mcp` | LLM advisor for the ECHIDNA formal-verification engine |
330+
| `agent-mcp` | OODA-loop agent session enforcer |
331+
| `local-coord-mcp` | **Multi-instance peer discovery + typed envelopes + supervision** (21 tools) |
332+
| `local-memory-mcp` | Persistent local memory for Claude, Cursor, Codex (13 tools, no cloud) |
333+
334+
Bridge-level tool: `boj_ml_huggingface`. `coord_*` tools (21) wire through `local-coord-mcp` — see the dedicated section below.
335+
336+
</details>
337+
338+
<details>
339+
<summary><b>🌐 Browser &amp; web automation</b> — 2 cartridges</summary>
340+
341+
| Cartridge | Description |
342+
|---|---|
343+
| `browser-mcp` | Firefox automation via Marionette — navigate, click, type, screenshot, exec JS |
344+
| `gossamer-mcp` | Native desktop windows — panel loading, JS bridge |
345+
346+
Bridge-level tools: `boj_browser_*` (7) — navigate, click, type, read_page, screenshot, tabs, execute_js.
347+
348+
</details>
349+
350+
<details>
351+
<summary><b>🔍 Code intelligence &amp; research</b> — 5 cartridges</summary>
352+
353+
| Cartridge | Description |
354+
|---|---|
355+
| `codeseeker-mcp` | **CodeSeeker** — vector + BM25 + path-tier fused via RRF; KG traversal; Graph-RAG |
356+
| `coderag-mcp` | Enterprise code intelligence — graph-based analysis for AI-assisted dev |
357+
| `research-mcp` | **Semantic Scholar / OpenAlex** — papers, citations, references, authors |
358+
| `opendatamcp` | Public dataset access for LLM apps |
359+
| `origenemcp` | Biomedical platform — 600+ tools/databases (ChEMBL, PubChem, FDA, OpenTargets) |
360+
361+
Bridge-level tools: `boj_codeseeker`, `boj_research`.
362+
363+
</details>
364+
365+
<details>
366+
<summary><b>🛠 Developer tooling (LSP/DAP/BSP, languages, registries)</b> — 14 cartridges</summary>
367+
368+
| Cartridge | Description |
369+
|---|---|
370+
| `lsp-mcp` | Generic Language Server Protocol 3.17 gateway — spawn any LSP server |
371+
| `dap-mcp` | Generic Debug Adapter Protocol gateway |
372+
| `bsp-mcp` | Generic Build Server Protocol 2.x gateway |
373+
| `lang-mcp` | Multi-language session manager — Eclexia, AffineScript, BetLang, Ephapax |
374+
| `toolchain-mcp` | Toolchain orchestrator — mint/provision/configure language toolchains |
375+
| `orchestrator-lsp-mcp` | Cross-domain LSP router across all 12 poly-*-lsp servers |
376+
| `affinescript-mcp` | **AffineScript** — type check, parse, format, lint, compile, hover, definition |
377+
| `typed-wasm-mcp` | **AffineScript → typed-wasm** at Level 7/10 ownership soundness |
378+
| `npm-registry-mcp` | npm — search, metadata, versions, downloads, dependency analysis |
379+
| `pypi-mcp` | PyPI — Python packages, search, metadata, versions, downloads |
380+
| `crates-mcp` | crates.io — Rust crates, search, metadata, versions, downloads |
381+
| `hackage-mcp` | Hackage — Haskell packages |
382+
| `hex-mcp` | Hex.pm — Elixir/Erlang packages |
383+
| `opam-mcp` | opam — OCaml packages |
384+
385+
Plus `opsm-mcp` (Odds-and-Sods Package Manager) routes search/install/dep-resolution across all of the above.
386+
387+
</details>
388+
389+
<details>
390+
<summary><b>🔒 Security &amp; secrets</b> — 7 cartridges</summary>
391+
392+
| Cartridge | Description |
393+
|---|---|
394+
| `secrets-mcp` | Secrets management — Vault, SOPS, env-vault |
395+
| `vault-mcp` | Vault CLI credential broker — execute, list, verify, rotate |
396+
| `sanctify-mcp` | Sanctify — PHP lint + deviation detection |
397+
| `panic-attack-mcp` | panic-attacker static analysis — dangerous patterns, banned constructs, drift |
398+
| `vext-mcp` | Vext — signed-message verification, attestation chains |
399+
| `rokur-mcp` | Rokur — Svalinn secrets GUI authorisation layer |
400+
| `dns-shield-mcp` | DNS security — DoQ, DoH, DNSSEC, CAA |
401+
402+
</details>
403+
404+
<details>
405+
<summary><b>🏗 Infrastructure-as-code, config &amp; proof</b> — 7 cartridges</summary>
406+
407+
| Cartridge | Description |
408+
|---|---|
409+
| `iac-mcp` | Terraform / OpenTofu lifecycle — plan → apply → destroy with state lifecycle |
410+
| `conflow-mcp` | Conflow — configuration management |
411+
| `bofig-mcp` | Bofig — evidence graph query for investigative workflows |
412+
| `proof-mcp` | Proof verification — Lean, Coq, Agda, Isabelle, Idris2, Z3, more |
413+
| `nesy-mcp` | **Neural-symbolic** harmonisation — symbolic truth overrides neural probability |
414+
| `ephapax-mcp` | Ephapax — proof-compiler query tools for formal verification |
415+
| `pmpl-mcp` | PMPL licence chain verification + artefact hashing |
416+
417+
</details>
418+
419+
<details>
420+
<summary><b>🌱 Hyperpolymath-native admin &amp; ecosystem</b> — 13 cartridges</summary>
421+
422+
| Cartridge | Description |
423+
|---|---|
424+
| `boj-health` | Self-health — status, ping, uptime |
425+
| `fleet-mcp` | gitbot-fleet gate compliance tracker |
426+
| `reposystem-mcp` | Reposystem — managed repos, health, mirrors, RSR compliance |
427+
| `007-mcp` | oo7 agent meta-language — parse/run/trace/build/test/lint |
428+
| `k9iser-mcp` | K9 contract regeneration (k9iser generate/validate/apply) |
429+
| `idaptik-admin-mcp` | IDApTIK game server administration |
430+
| `burble-admin-mcp` | Burble WebRTC server administration |
431+
| `game-admin-mcp` | Game server admin + configuration drift |
432+
| `aerie-mcp` | Aerie environment lifecycle manager |
433+
| `hesiod-mcp` | DNS lookup cartridge |
434+
| `fireflag-mcp` | Fireflag — extension-to-MCP mapping and discovery |
435+
| `kategoria-mcp` | Type-theory learning system — classification + learner evaluation |
436+
| `civic-connect-mcp` | CivicConnect community engagement platform |
437+
438+
Plus `feedback-mcp` (feedback collection + sentiment), `ssg-mcp` (Hugo/Zola/Astro/Casket), `ums-mcp` (Universal Map Specification level editor).
439+
440+
</details>
441+
442+
### Bridge-level tools (41 exposed)
443+
444+
A subset of cartridges have explicit `boj_<domain>_<verb>` tools at the bridge for highest-frequency operations. Everything else is reachable via `boj_cartridge_invoke`:
445+
446+
- **5 core**: `boj_health`, `boj_menu`, `boj_cartridges`, `boj_cartridge_info`, `boj_cartridge_invoke`
447+
- **3 cloud**: `boj_cloud_verpex`, `boj_cloud_cloudflare`, `boj_cloud_vercel`
448+
- **2 comms**: `boj_comms_gmail`, `boj_comms_calendar`
449+
- **1 ML**: `boj_ml_huggingface`
450+
- **7 browser**: `boj_browser_navigate`, `boj_browser_click`, `boj_browser_type`, `boj_browser_read_page`, `boj_browser_screenshot`, `boj_browser_tabs`, `boj_browser_execute_js`
451+
- **14 GitHub** + **8 GitLab**
452+
- **1 CodeSeeker**, **1 research**
453+
- **21 coord** (see below)
454+
455+
Set `BOJ_TOOL_SCOPE=core` to advertise only the discovery surface; explicit tools remain reachable via `boj_cartridge_invoke` regardless.
210456

211457
## Local-coord-mcp at a glance
212458

0 commit comments

Comments
 (0)