gabbe-kit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/LICENSE +25 -0
  2. package/LICENSE-CODE +202 -0
  3. package/README.md +817 -0
  4. package/agents/AGENTS.md +542 -0
  5. package/agents/CONSTITUTION.md +188 -0
  6. package/agents/guides/00-index.md +142 -0
  7. package/agents/guides/ai/a2ui-protocols.md +71 -0
  8. package/agents/guides/ai/actor-agent-frameworks.md +82 -0
  9. package/agents/guides/ai/agent-communication.md +146 -0
  10. package/agents/guides/ai/agent-identity-trust.md +69 -0
  11. package/agents/guides/ai/agent-only-cognition.md +73 -0
  12. package/agents/guides/ai/agent-only-swarms.md +70 -0
  13. package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
  14. package/agents/guides/ai/agent-ui.md +106 -0
  15. package/agents/guides/ai/ai-agentic.md +309 -0
  16. package/agents/guides/ai/beyond-llms.md +60 -0
  17. package/agents/guides/ai/dynamic-capability-loading.md +121 -0
  18. package/agents/guides/ai/gabbe-innovations.md +111 -0
  19. package/agents/guides/ai/model-customization-decisions.md +78 -0
  20. package/agents/guides/ai/multi-agent-systems.md +85 -0
  21. package/agents/guides/ai/self-evolving-skills.md +137 -0
  22. package/agents/guides/ai/self-healing-summary.md +21 -0
  23. package/agents/guides/ai/visual-mcp-integration.md +106 -0
  24. package/agents/guides/architecture/api-standards.md +61 -0
  25. package/agents/guides/architecture/blockchain-dlt.md +36 -0
  26. package/agents/guides/architecture/critical-systems-arch.md +66 -0
  27. package/agents/guides/architecture/event-driven-architecture.md +39 -0
  28. package/agents/guides/architecture/microservices.md +292 -0
  29. package/agents/guides/architecture/monolith.md +303 -0
  30. package/agents/guides/architecture/orchestration.md +75 -0
  31. package/agents/guides/architecture/system-qualities.md +51 -0
  32. package/agents/guides/architecture/system-scalability.md +47 -0
  33. package/agents/guides/architecture/systems-architecture.md +506 -0
  34. package/agents/guides/data/semantic-web.md +23 -0
  35. package/agents/guides/data/sql-nosql.md +305 -0
  36. package/agents/guides/industry/engineering-standards.md +36 -0
  37. package/agents/guides/industry/global-standards.md +24 -0
  38. package/agents/guides/industry/healthcare-fhir.md +33 -0
  39. package/agents/guides/industry/industrial-iot.md +33 -0
  40. package/agents/guides/industry/telecom-networks.md +34 -0
  41. package/agents/guides/languages/c-sharp.md +66 -0
  42. package/agents/guides/languages/go-lang.md +251 -0
  43. package/agents/guides/languages/java.md +73 -0
  44. package/agents/guides/languages/js-ts-nodejs.md +361 -0
  45. package/agents/guides/languages/nodejs-advanced.md +56 -0
  46. package/agents/guides/languages/php-laravel.md +376 -0
  47. package/agents/guides/languages/python-fastapi-ai.md +257 -0
  48. package/agents/guides/languages/rust.md +73 -0
  49. package/agents/guides/ops/compliance-audit.md +177 -0
  50. package/agents/guides/ops/cost-optimization.md +57 -0
  51. package/agents/guides/ops/dev-environments.md +67 -0
  52. package/agents/guides/ops/dev-workflow.md +44 -0
  53. package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
  54. package/agents/guides/ops/production-health.md +62 -0
  55. package/agents/guides/ops/troubleshooting-guide.md +69 -0
  56. package/agents/guides/patterns/agentic-design-patterns.md +308 -0
  57. package/agents/guides/patterns/agentic-patterns.md +43 -0
  58. package/agents/guides/patterns/ai-native-scenarios.md +71 -0
  59. package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
  60. package/agents/guides/patterns/design-patterns.md +68 -0
  61. package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
  62. package/agents/guides/patterns/enterprise-patterns.md +56 -0
  63. package/agents/guides/patterns/software-design-patterns.md +106 -0
  64. package/agents/guides/patterns/time-complexity-analysis.md +116 -0
  65. package/agents/guides/planning/product-requirements.md +407 -0
  66. package/agents/guides/planning/strategic-analysis.md +98 -0
  67. package/agents/guides/planning/visual-product-specs.md +162 -0
  68. package/agents/guides/principles/clean-code-standards.md +51 -0
  69. package/agents/guides/principles/computing-foundations.md +87 -0
  70. package/agents/guides/principles/diagramming-standards.md +568 -0
  71. package/agents/guides/principles/evaluation-strategy.md +103 -0
  72. package/agents/guides/principles/future-tech.md +35 -0
  73. package/agents/guides/principles/human-agent-collaboration.md +54 -0
  74. package/agents/guides/principles/legacy-tech.md +61 -0
  75. package/agents/guides/principles/mathematical-foundations.md +103 -0
  76. package/agents/guides/principles/modeling-methods.md +97 -0
  77. package/agents/guides/principles/no-code-integration.md +84 -0
  78. package/agents/guides/principles/testing-strategy.md +97 -0
  79. package/agents/guides/principles/visual-design-system.md +44 -0
  80. package/agents/guides/processes/RARV_CYCLE.md +262 -0
  81. package/agents/guides/processes/extension-protocol.md +183 -0
  82. package/agents/guides/processes/full-system-lifecycle.md +47 -0
  83. package/agents/guides/processes/knowledge-integration.md +82 -0
  84. package/agents/guides/processes/loki-sdlc-phases.md +446 -0
  85. package/agents/guides/product/green-software.md +38 -0
  86. package/agents/guides/product/sustainability-checks.md +29 -0
  87. package/agents/guides/security/ai-risk-standards-map.md +98 -0
  88. package/agents/guides/security/api-security.md +51 -0
  89. package/agents/guides/security/cryptography-standards.md +38 -0
  90. package/agents/guides/security/privacy-data-protection.md +41 -0
  91. package/agents/guides/security/secure-architecture.md +43 -0
  92. package/agents/guides/security/threat-modeling.md +46 -0
  93. package/agents/memory/AUDIT_LOG.md +48 -0
  94. package/agents/memory/CONTINUITY.md +49 -0
  95. package/agents/memory/PROJECT_STATE.md +134 -0
  96. package/agents/memory/RESUME_POINTER.md +15 -0
  97. package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
  98. package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
  99. package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
  100. package/agents/personas/00-index.md +148 -0
  101. package/agents/personas/biz-compliance.md +112 -0
  102. package/agents/personas/biz-legal.md +131 -0
  103. package/agents/personas/eng-api.md +110 -0
  104. package/agents/personas/eng-backend.md +113 -0
  105. package/agents/personas/eng-data.md +50 -0
  106. package/agents/personas/eng-database.md +95 -0
  107. package/agents/personas/eng-frontend.md +75 -0
  108. package/agents/personas/eng-infra.md +105 -0
  109. package/agents/personas/eng-messaging.md +50 -0
  110. package/agents/personas/eng-ml.md +50 -0
  111. package/agents/personas/eng-mobile.md +75 -0
  112. package/agents/personas/eng-perf.md +90 -0
  113. package/agents/personas/eng-qa.md +125 -0
  114. package/agents/personas/eng-tooling.md +49 -0
  115. package/agents/personas/ops-compliance.md +109 -0
  116. package/agents/personas/ops-cost.md +92 -0
  117. package/agents/personas/ops-devops.md +85 -0
  118. package/agents/personas/ops-incident.md +123 -0
  119. package/agents/personas/ops-monitor.md +89 -0
  120. package/agents/personas/ops-release.md +91 -0
  121. package/agents/personas/ops-security.md +104 -0
  122. package/agents/personas/ops-sre.md +85 -0
  123. package/agents/personas/orch-coordinator.md +140 -0
  124. package/agents/personas/orch-judge.md +135 -0
  125. package/agents/personas/orch-planner.md +114 -0
  126. package/agents/personas/orch-researcher.md +165 -0
  127. package/agents/personas/prod-architect.md +110 -0
  128. package/agents/personas/prod-design.md +112 -0
  129. package/agents/personas/prod-ethicist.md +50 -0
  130. package/agents/personas/prod-integration.md +120 -0
  131. package/agents/personas/prod-pm.md +115 -0
  132. package/agents/personas/prod-product-ops.md +128 -0
  133. package/agents/personas/prod-research.md +49 -0
  134. package/agents/personas/prod-safety-engineer.md +28 -0
  135. package/agents/personas/prod-tech-lead.md +119 -0
  136. package/agents/personas/ui-design.md +81 -0
  137. package/agents/scripts/check_skills_docs.py +120 -0
  138. package/agents/scripts/compile_skills.py +284 -0
  139. package/agents/scripts/comprehensive_checker.py +187 -0
  140. package/agents/scripts/dump-context.sh +37 -0
  141. package/agents/scripts/eval_skills.py +268 -0
  142. package/agents/scripts/preflight_summary.sh +80 -0
  143. package/agents/scripts/report_duplicates.py +125 -0
  144. package/agents/scripts/setup-context.ps1 +250 -0
  145. package/agents/scripts/setup-context.sh +398 -0
  146. package/agents/scripts/state_export.sh +84 -0
  147. package/agents/scripts/state_import.sh +99 -0
  148. package/agents/scripts/validate_integrity.py +98 -0
  149. package/agents/scripts/validate_links.py +96 -0
  150. package/agents/scripts/validate_methodology_graph.py +194 -0
  151. package/agents/scripts/validate_skills.py +81 -0
  152. package/agents/scripts/verify_e2e_init_flows.py +246 -0
  153. package/agents/scripts/verify_setup_simulation.py +104 -0
  154. package/agents/scripts/verify_triggers_and_mcps.py +159 -0
  155. package/agents/scripts/verify_use_cases.py +498 -0
  156. package/agents/skills/00-index.md +322 -0
  157. package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
  158. package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
  159. package/agents/skills/ai/agent-communication.skill.md +36 -0
  160. package/agents/skills/ai/agent-ui.skill.md +31 -0
  161. package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
  162. package/agents/skills/ai/beyond-llms.skill.md +31 -0
  163. package/agents/skills/ai/context-engineering.skill.md +79 -0
  164. package/agents/skills/ai/llm-as-judge.skill.md +97 -0
  165. package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
  166. package/agents/skills/ai/rag-evaluation.skill.md +93 -0
  167. package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
  168. package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
  169. package/agents/skills/architecture/api-design.skill.md +92 -0
  170. package/agents/skills/architecture/api-standards.skill.md +31 -0
  171. package/agents/skills/architecture/arch-debt.skill.md +180 -0
  172. package/agents/skills/architecture/arch-design.skill.md +304 -0
  173. package/agents/skills/architecture/arch-patterns.skill.md +52 -0
  174. package/agents/skills/architecture/arch-review.skill.md +326 -0
  175. package/agents/skills/architecture/architecture-governance.skill.md +62 -0
  176. package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
  177. package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
  178. package/agents/skills/architecture/compatibility-design.skill.md +51 -0
  179. package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
  180. package/agents/skills/architecture/design-patterns.skill.md +59 -0
  181. package/agents/skills/architecture/diagramming.skill.md +380 -0
  182. package/agents/skills/architecture/domain-model.skill.md +294 -0
  183. package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
  184. package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
  185. package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
  186. package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
  187. package/agents/skills/architecture/event-governance.skill.md +55 -0
  188. package/agents/skills/architecture/fitness-functions.skill.md +111 -0
  189. package/agents/skills/architecture/graphql-schema.skill.md +64 -0
  190. package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
  191. package/agents/skills/architecture/microservices.skill.md +31 -0
  192. package/agents/skills/architecture/middleware-design.skill.md +59 -0
  193. package/agents/skills/architecture/monolith.skill.md +31 -0
  194. package/agents/skills/architecture/realtime-comm.skill.md +52 -0
  195. package/agents/skills/architecture/state-management.skill.md +72 -0
  196. package/agents/skills/architecture/system-qualities.skill.md +31 -0
  197. package/agents/skills/architecture/system-scalability.skill.md +31 -0
  198. package/agents/skills/architecture/systems-architecture.skill.md +31 -0
  199. package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
  200. package/agents/skills/brain/README.md +70 -0
  201. package/agents/skills/brain/active-inference.skill.md +74 -0
  202. package/agents/skills/brain/brain-mode.skill.md +125 -0
  203. package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
  204. package/agents/skills/brain/cognitive-testing.skill.md +62 -0
  205. package/agents/skills/brain/consciousness-loop.skill.md +68 -0
  206. package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
  207. package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
  208. package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
  209. package/agents/skills/brain/global-workspace.skill.md +77 -0
  210. package/agents/skills/brain/learning-adaptation.skill.md +68 -0
  211. package/agents/skills/brain/loki-mode.skill.md +267 -0
  212. package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
  213. package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
  214. package/agents/skills/brain/scripts/cognition_test.py +80 -0
  215. package/agents/skills/brain/scripts/global_workspace.py +104 -0
  216. package/agents/skills/brain/self-improvement.skill.md +80 -0
  217. package/agents/skills/brain/sensory-motor.skill.md +61 -0
  218. package/agents/skills/brain/sequential-thinking.skill.md +48 -0
  219. package/agents/skills/brain/working-memory.skill.md +47 -0
  220. package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
  221. package/agents/skills/coding/artisan-commands.skill.md +52 -0
  222. package/agents/skills/coding/browser-tdd.skill.md +131 -0
  223. package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
  224. package/agents/skills/coding/ci-autofix.skill.md +53 -0
  225. package/agents/skills/coding/clean-coder.skill.md +58 -0
  226. package/agents/skills/coding/code-review.skill.md +100 -0
  227. package/agents/skills/coding/debug.skill.md +100 -0
  228. package/agents/skills/coding/documentation.skill.md +149 -0
  229. package/agents/skills/coding/eval-driven-development.skill.md +107 -0
  230. package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
  231. package/agents/skills/coding/excalidraw.skill.md +90 -0
  232. package/agents/skills/coding/file-processing.skill.md +55 -0
  233. package/agents/skills/coding/git-workflow.skill.md +153 -0
  234. package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
  235. package/agents/skills/coding/mobile-dev.skill.md +41 -0
  236. package/agents/skills/coding/nodejs-expert.skill.md +23 -0
  237. package/agents/skills/coding/output-validation.skill.md +57 -0
  238. package/agents/skills/coding/pbt-strategy.skill.md +117 -0
  239. package/agents/skills/coding/performant-ai.skill.md +62 -0
  240. package/agents/skills/coding/performant-go.skill.md +61 -0
  241. package/agents/skills/coding/performant-laravel.skill.md +70 -0
  242. package/agents/skills/coding/performant-nodejs.skill.md +67 -0
  243. package/agents/skills/coding/performant-php.skill.md +53 -0
  244. package/agents/skills/coding/performant-python.skill.md +62 -0
  245. package/agents/skills/coding/refactor.skill.md +124 -0
  246. package/agents/skills/coding/secure-coding.skill.md +57 -0
  247. package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
  248. package/agents/skills/coding/spec-driven-development.skill.md +110 -0
  249. package/agents/skills/coding/tdd-cycle.skill.md +92 -0
  250. package/agents/skills/coding/testing-strategy.skill.md +74 -0
  251. package/agents/skills/coding/time-complexity.skill.md +112 -0
  252. package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
  253. package/agents/skills/coding/tool-construction.skill.md +47 -0
  254. package/agents/skills/coding/ui-gen.skill.md +64 -0
  255. package/agents/skills/coding/vibe-coding.skill.md +63 -0
  256. package/agents/skills/coding/visual-design.skill.md +65 -0
  257. package/agents/skills/coordination/agent-interop.skill.md +72 -0
  258. package/agents/skills/coordination/agent-protocol.skill.md +62 -0
  259. package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
  260. package/agents/skills/coordination/agentic-linter.skill.md +134 -0
  261. package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
  262. package/agents/skills/coordination/meta-optimize.skill.md +62 -0
  263. package/agents/skills/coordination/meta-prompting.skill.md +46 -0
  264. package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
  265. package/agents/skills/coordination/persona-selector.skill.md +78 -0
  266. package/agents/skills/coordination/self-optimize.skill.md +81 -0
  267. package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
  268. package/agents/skills/core/agent-analytics.skill.md +74 -0
  269. package/agents/skills/core/audit-trail.skill.md +122 -0
  270. package/agents/skills/core/clarify.skill.md +89 -0
  271. package/agents/skills/core/emerging-tech.skill.md +52 -0
  272. package/agents/skills/core/empirical-methods.skill.md +101 -0
  273. package/agents/skills/core/evals/clarify.eval.yaml +29 -0
  274. package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
  275. package/agents/skills/core/evals/research.eval.yaml +23 -0
  276. package/agents/skills/core/final-review.skill.md +66 -0
  277. package/agents/skills/core/integrity-check.skill.md +149 -0
  278. package/agents/skills/core/knowledge-connect.skill.md +77 -0
  279. package/agents/skills/core/knowledge-gap.skill.md +123 -0
  280. package/agents/skills/core/preflight.skill.md +106 -0
  281. package/agents/skills/core/research.skill.md +107 -0
  282. package/agents/skills/core/retrospective.skill.md +59 -0
  283. package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
  284. package/agents/skills/core/self-heal.skill.md +163 -0
  285. package/agents/skills/core/session-resume.skill.md +125 -0
  286. package/agents/skills/core/skills-registry.skill.md +65 -0
  287. package/agents/skills/core/state-portability.skill.md +89 -0
  288. package/agents/skills/core/state-preserve.skill.md +76 -0
  289. package/agents/skills/core/system-lifecycle.skill.md +51 -0
  290. package/agents/skills/core/update-scan.skill.md +92 -0
  291. package/agents/skills/data/data-engineering.skill.md +56 -0
  292. package/agents/skills/data/data-governance.skill.md +49 -0
  293. package/agents/skills/data/db-migration.skill.md +136 -0
  294. package/agents/skills/data/semantic-web.skill.md +28 -0
  295. package/agents/skills/data/sql-optimization.skill.md +78 -0
  296. package/agents/skills/industry/engineering-standards.skill.md +31 -0
  297. package/agents/skills/industry/global-standards.skill.md +30 -0
  298. package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
  299. package/agents/skills/industry/industrial-iot.skill.md +30 -0
  300. package/agents/skills/industry/telecom-networks.skill.md +30 -0
  301. package/agents/skills/ops/caching-strategy.skill.md +77 -0
  302. package/agents/skills/ops/capacity-planning.skill.md +67 -0
  303. package/agents/skills/ops/cloud-deploy.skill.md +55 -0
  304. package/agents/skills/ops/configuration-management.skill.md +107 -0
  305. package/agents/skills/ops/cost-optimization.skill.md +39 -0
  306. package/agents/skills/ops/decommission-sunset.skill.md +64 -0
  307. package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
  308. package/agents/skills/ops/deployment.skill.md +217 -0
  309. package/agents/skills/ops/dev-environments.skill.md +31 -0
  310. package/agents/skills/ops/dev-workflow.skill.md +28 -0
  311. package/agents/skills/ops/docker-dev.skill.md +52 -0
  312. package/agents/skills/ops/enterprise-integration.skill.md +53 -0
  313. package/agents/skills/ops/feature-flag-management.skill.md +59 -0
  314. package/agents/skills/ops/incident-response.skill.md +40 -0
  315. package/agents/skills/ops/infra-devops.skill.md +53 -0
  316. package/agents/skills/ops/k8s-dev.skill.md +51 -0
  317. package/agents/skills/ops/memory-optimization.skill.md +45 -0
  318. package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
  319. package/agents/skills/ops/performance-audit.skill.md +178 -0
  320. package/agents/skills/ops/performance-optimization.skill.md +51 -0
  321. package/agents/skills/ops/production-health.skill.md +85 -0
  322. package/agents/skills/ops/production-verifier.skill.md +50 -0
  323. package/agents/skills/ops/queue-management.skill.md +52 -0
  324. package/agents/skills/ops/release-management.skill.md +39 -0
  325. package/agents/skills/ops/release-validation.skill.md +51 -0
  326. package/agents/skills/ops/reliability-sre.skill.md +51 -0
  327. package/agents/skills/ops/runbook-authoring.skill.md +64 -0
  328. package/agents/skills/ops/system-benchmark.skill.md +69 -0
  329. package/agents/skills/ops/tech-debt.skill.md +143 -0
  330. package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
  331. package/agents/skills/product/accessibility.skill.md +143 -0
  332. package/agents/skills/product/adr-writer.skill.md +110 -0
  333. package/agents/skills/product/business-case.skill.md +70 -0
  334. package/agents/skills/product/change-management.skill.md +90 -0
  335. package/agents/skills/product/decompose.skill.md +75 -0
  336. package/agents/skills/product/design-thinking.skill.md +62 -0
  337. package/agents/skills/product/estimation-sizing.skill.md +87 -0
  338. package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
  339. package/agents/skills/product/financial-governance.skill.md +88 -0
  340. package/agents/skills/product/green-software.skill.md +46 -0
  341. package/agents/skills/product/ideation-facilitation.skill.md +87 -0
  342. package/agents/skills/product/market-analysis.skill.md +56 -0
  343. package/agents/skills/product/opportunity-assessment.skill.md +89 -0
  344. package/agents/skills/product/product-analytics.skill.md +92 -0
  345. package/agents/skills/product/professional-practice.skill.md +105 -0
  346. package/agents/skills/product/req-elicitation.skill.md +292 -0
  347. package/agents/skills/product/req-review.skill.md +280 -0
  348. package/agents/skills/product/spec-analyze.skill.md +98 -0
  349. package/agents/skills/product/spec-writer.skill.md +114 -0
  350. package/agents/skills/product/stakeholder-management.skill.md +54 -0
  351. package/agents/skills/product/sustainability-checks.skill.md +29 -0
  352. package/agents/skills/product/systems-thinking.skill.md +56 -0
  353. package/agents/skills/product/user-research-synthesis.skill.md +85 -0
  354. package/agents/skills/product/user-story-mapping.skill.md +54 -0
  355. package/agents/skills/product/visual-specs.skill.md +112 -0
  356. package/agents/skills/security/access-control.skill.md +45 -0
  357. package/agents/skills/security/agent-sandboxing.skill.md +69 -0
  358. package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
  359. package/agents/skills/security/ai-red-teaming.skill.md +74 -0
  360. package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
  361. package/agents/skills/security/api-security.skill.md +31 -0
  362. package/agents/skills/security/backup-recovery.skill.md +49 -0
  363. package/agents/skills/security/compliance-review.skill.md +152 -0
  364. package/agents/skills/security/cryptography-standards.skill.md +31 -0
  365. package/agents/skills/security/dependency-security.skill.md +47 -0
  366. package/agents/skills/security/hazard-analysis.skill.md +53 -0
  367. package/agents/skills/security/legal-review.skill.md +41 -0
  368. package/agents/skills/security/log-analysis.skill.md +68 -0
  369. package/agents/skills/security/network-security.skill.md +64 -0
  370. package/agents/skills/security/privacy-audit.skill.md +137 -0
  371. package/agents/skills/security/privacy-data-protection.skill.md +31 -0
  372. package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
  373. package/agents/skills/security/reliability-engineering.skill.md +47 -0
  374. package/agents/skills/security/safety-scan.skill.md +49 -0
  375. package/agents/skills/security/secrets-management.skill.md +65 -0
  376. package/agents/skills/security/secure-architecture.skill.md +31 -0
  377. package/agents/skills/security/security-audit.skill.md +164 -0
  378. package/agents/skills/security/threat-model.skill.md +120 -0
  379. package/agents/skills/security/traceability-audit.skill.md +48 -0
  380. package/agents/templates/00-index.md +162 -0
  381. package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
  382. package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
  383. package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
  384. package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
  385. package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
  386. package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
  387. package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
  388. package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
  389. package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
  390. package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
  391. package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
  392. package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
  393. package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
  394. package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
  395. package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
  396. package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
  397. package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
  398. package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
  399. package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
  400. package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
  401. package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
  402. package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
  403. package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
  404. package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
  405. package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
  406. package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
  407. package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
  408. package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
  409. package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
  410. package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
  411. package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
  412. package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
  413. package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
  414. package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
  415. package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
  416. package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
  417. package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
  418. package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
  419. package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
  420. package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
  421. package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
  422. package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
  423. package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
  424. package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
  425. package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
  426. package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
  427. package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
  428. package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
  429. package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
  430. package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
  431. package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
  432. package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
  433. package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
  434. package/agents/templates/core/SDLC_TRACKER.md +217 -0
  435. package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
  436. package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
  437. package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
  438. package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
  439. package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
  440. package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
  441. package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
  442. package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
  443. package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
  444. package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
  445. package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
  446. package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
  447. package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
  448. package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
  449. package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
  450. package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
  451. package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
  452. package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
  453. package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
  454. package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
  455. package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
  456. package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
  457. package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
  458. package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
  459. package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
  460. package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
  461. package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
  462. package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
  463. package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
  464. package/agents/templates/product/NFR_TEMPLATE.md +31 -0
  465. package/agents/templates/product/PRD_TEMPLATE.md +222 -0
  466. package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
  467. package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
  468. package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
  469. package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
  470. package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
  471. package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
  472. package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
  473. package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
  474. package/agents/templates/security/HAZARD_LOG.md +17 -0
  475. package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
  476. package/agents/templates/security/SAFETY_CASE.md +39 -0
  477. package/agents/templates/security/SAFETY_POLICY.md +25 -0
  478. package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
  479. package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
  480. package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
  481. package/bin/install.js +572 -0
  482. package/docs/CLI_REFERENCE.md +527 -0
  483. package/docs/INSTALL.md +68 -0
  484. package/docs/MCP_CONFIGURATIONS.md +1765 -0
  485. package/docs/PLATFORM_CONTROLS.md +324 -0
  486. package/docs/POST_INSTALL.md +75 -0
  487. package/docs/QUICK_COMMANDS.md +131 -0
  488. package/docs/QUICK_GUIDE.md +914 -0
  489. package/docs/README_FULL.md +1451 -0
  490. package/docs/SCHEMA.md +164 -0
  491. package/docs/V1_RELEASE_CHECKLIST.md +144 -0
  492. package/docs/VERIFICATION_GUIDE.md +283 -0
  493. package/docs/adr/0001-record-architecture-decisions.md +26 -0
  494. package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
  495. package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
  496. package/docs/assets/GABBE.png +0 -0
  497. package/docs/gabbe.config.example.json +9 -0
  498. package/docs/reports/duplication-report.md +30 -0
  499. package/install.ps1 +90 -0
  500. package/install.sh +89 -0
  501. package/package.json +49 -0
  502. package/scripts/init.py +1036 -0
@@ -0,0 +1,1765 @@
1
+ # MCP Server Configurations Guide
2
+
3
+ > **Audience:** users wiring MCP servers. **Scope:** install/config/usage for every supported MCP server (package names verified 2026-06-10).
4
+
5
+ Comprehensive installation, configuration, and usage guide for every MCP (Model Context Protocol) server supported by the GABBE kit.
6
+
7
+ > **Config file**: `agents/templates/core/MCP_CONFIG_TEMPLATE.json`
8
+ > **How to apply**: Copy the relevant server entry into your tool's MCP config (Claude `.mcp.json`, VS Code `.vscode/mcp.json`, Cursor settings, etc.) and restart.
9
+ > **Prerequisites**: Node.js 18+ and `npx` available in PATH for all `npx`-based servers.
10
+
11
+ > [!IMPORTANT]
12
+ > **Package names verified 2026-06-10** against the npm/PyPI registries. Several
13
+ > entries were corrected to their current upstream package (e.g. Context7 →
14
+ > `@upstash/context7-mcp`, Sentry → `@sentry/mcp-server`, Stripe → `@stripe/mcp`,
15
+ > Azure → `@azure/mcp`). The `@modelcontextprotocol/server-*` reference servers
16
+ > are **archived** (still installable, no longer maintained) — prefer official
17
+ > successors where they exist (e.g. the GitHub MCP is now the Go
18
+ > `github-mcp-server`/Docker image).
19
+ >
20
+ > **Hosted / desktop servers (no `npx` package)** — connect via the vendor's URL
21
+ > or app instead of installing: **Zapier** (per-user URL at `mcp.zapier.com`),
22
+ > **Vercel** (hosted MCP + `@vercel/mcp-adapter` to build your own), **Datadog**
23
+ > (hosted MCP), **Figma** (Dev Mode MCP in the Figma desktop app), **Docker**
24
+ > (MCP Toolkit in Docker Desktop). **AWS** ships `awslabs.*` servers on PyPI;
25
+ > **Grafana** ships the Go `mcp-grafana`; **HashiCorp Terraform** ships a
26
+ > Docker/Go `terraform-mcp-server`; **Confluence/Jira** use community Atlassian
27
+ > servers (e.g. `mcp-atlassian`, `@aashari/mcp-server-atlassian-*`). The
28
+ > `@anthropic/mcp-server-shell` entry has no published package and should not be
29
+ > used. See `OpenSourceAudit/projects/GABBE/mcp-verification-2026-06.md` for the
30
+ > full per-server status.
31
+
32
+ ---
33
+
34
+ ## Table of Contents
35
+
36
+ 1. [Essential Servers](#1-essential-servers)
37
+ 2. [Version Control & Project Management](#2-version-control--project-management)
38
+ 3. [Databases](#3-databases)
39
+ 4. [Security & Code Quality](#4-security--code-quality)
40
+ 5. [Observability & Monitoring](#5-observability--monitoring)
41
+ 6. [Browser & Web](#6-browser--web)
42
+ 7. [Cloud & Infrastructure](#7-cloud--infrastructure)
43
+ 8. [Design & Visual Architecture](#8-design--visual-architecture)
44
+ 9. [Knowledge Bases & Vector Databases](#9-knowledge-bases--vector-databases)
45
+ 10. [Project Management & Collaboration](#10-project-management--collaboration)
46
+ 11. [API Introspection & Knowledge](#11-api-introspection--knowledge)
47
+ 12. [Payments & Automation](#12-payments--automation)
48
+ 13. [Security Rules & Best Practices](#13-security-rules--best-practices)
49
+ 14. [Environment Variables Summary](#14-environment-variables-summary)
50
+
51
+ ---
52
+
53
+ > **GABBE's own MCP server (`gabbe serve-mcp`) hardens its tool inputs.** The
54
+ > `run_command` tool input is a single bounded JSON Schema contract: the `command`
55
+ > string is constrained by **charset** (a `pattern` forbidding control characters
56
+ > and NUL) and **length** (`maxLength`), with `additionalProperties: false`. This
57
+ > defends against injection-via-tool-feedback and oversized payloads (MCP-38
58
+ > threat taxonomy / NSA MCP guidance) and is regression-tested by
59
+ > `gabbe/tests/test_mcp_contract.py`. When authoring downstream MCP tool schemas,
60
+ > apply the same rule: never expose a `type: "string"` input without bounding its
61
+ > length and character set.
62
+
63
+ ## 1. Essential Servers
64
+
65
+ These servers are recommended for **every project**.
66
+
67
+ ---
68
+
69
+ ### Context7
70
+
71
+ Up-to-date SDK documentation — prevents the agent from hallucinating deprecated APIs.
72
+
73
+ | Property | Value |
74
+ |---|---|
75
+ | **Package** | `@upstash/context7-mcp` |
76
+ | **Website** | [context7.com](https://context7.com) |
77
+ | **API Key** | None required |
78
+ | **GABBE Skill** | `research.skill`, all coding skills |
79
+
80
+ **Install & Config:**
81
+ ```json
82
+ {
83
+ "context7": {
84
+ "command": "npx",
85
+ "args": ["@upstash/context7-mcp"],
86
+ "env": {}
87
+ }
88
+ }
89
+ ```
90
+
91
+ **Usage:**
92
+ ```
93
+ > "Use Context7 to look up the latest Next.js App Router API before implementing."
94
+ ```
95
+
96
+ ---
97
+
98
+ ### Sequential Thinking
99
+
100
+ Structured chain-of-thought reasoning before acting. Improves planning quality for complex tasks.
101
+
102
+ | Property | Value |
103
+ |---|---|
104
+ | **Package** | `@modelcontextprotocol/server-sequential-thinking` |
105
+ | **Website** | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
106
+ | **API Key** | None required |
107
+ | **GABBE Skill** | `brain/sequential-thinking.skill` |
108
+
109
+ **Install & Config:**
110
+ ```json
111
+ {
112
+ "sequential-thinking": {
113
+ "command": "npx",
114
+ "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
115
+ "env": {}
116
+ }
117
+ }
118
+ ```
119
+
120
+ ---
121
+
122
+ ### Brave Search
123
+
124
+ Authoritative web research with source filtering. Powers the `research.skill`.
125
+
126
+ | Property | Value |
127
+ |---|---|
128
+ | **Package** | `@modelcontextprotocol/server-brave-search` |
129
+ | **Website** | [brave.com/search/api](https://brave.com/search/api/) |
130
+ | **API Key** | **Required**: `BRAVE_API_KEY` |
131
+ | **Get API Key** | [api.search.brave.com/register](https://api.search.brave.com/register) (free tier available) |
132
+ | **GABBE Skill** | `core/research.skill` |
133
+
134
+ **Install & Config:**
135
+ ```json
136
+ {
137
+ "brave-search": {
138
+ "command": "npx",
139
+ "args": ["-y", "@modelcontextprotocol/server-brave-search"],
140
+ "env": {
141
+ "BRAVE_API_KEY": "${BRAVE_API_KEY}"
142
+ }
143
+ }
144
+ }
145
+ ```
146
+
147
+ **Usage:**
148
+ ```
149
+ > "Research the latest OAuth 2.1 specification changes using authoritative sources."
150
+ ```
151
+
152
+ ---
153
+
154
+ ### Filesystem
155
+
156
+ Read-only access to local project files for knowledge ingestion (internal RAG).
157
+
158
+ | Property | Value |
159
+ |---|---|
160
+ | **Package** | `@modelcontextprotocol/server-filesystem` |
161
+ | **Website** | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
162
+ | **API Key** | None required |
163
+ | **Security** | Restrict path argument to project directory only |
164
+ | **GABBE Skill** | `core/knowledge-connect.skill` |
165
+
166
+ **Install & Config:**
167
+ ```json
168
+ {
169
+ "filesystem": {
170
+ "command": "npx",
171
+ "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"],
172
+ "env": {}
173
+ }
174
+ }
175
+ ```
176
+
177
+ > [!WARNING]
178
+ > Never pass system directories (`/etc`, `/home`, `~`) as the path argument. Restrict to `./` (project root).
179
+
180
+ ---
181
+
182
+ ## 2. Version Control & Project Management
183
+
184
+ ---
185
+
186
+ ### GitHub
187
+
188
+ PR review, code search, issue management, and git history.
189
+
190
+ | Property | Value |
191
+ |---|---|
192
+ | **Package** | `@modelcontextprotocol/server-github` |
193
+ | **Website** | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
194
+ | **API Key** | **Required**: `GITHUB_TOKEN` (Personal Access Token with `repo` scope) |
195
+ | **Get API Key** | GitHub → Settings → Developer Settings → Personal Access Tokens |
196
+ | **GABBE Skill** | `coding/git-workflow.skill`, `coding/code-review.skill` |
197
+
198
+ **Install & Config:**
199
+ ```json
200
+ {
201
+ "github": {
202
+ "command": "npx",
203
+ "args": ["-y", "@modelcontextprotocol/server-github"],
204
+ "env": {
205
+ "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
206
+ }
207
+ }
208
+ }
209
+ ```
210
+
211
+ **Usage:**
212
+ ```
213
+ > "Create a PR from feature/auth to main with a summary of changes."
214
+ > "Search for all open issues labeled 'bug' in this repo."
215
+ ```
216
+
217
+ ---
218
+
219
+ ### GitLab
220
+
221
+ GitLab alternative to the GitHub MCP. Same capabilities for GitLab-hosted repos.
222
+
223
+ | Property | Value |
224
+ |---|---|
225
+ | **Package** | `@modelcontextprotocol/server-gitlab` |
226
+ | **Website** | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
227
+ | **API Key** | **Required**: `GITLAB_TOKEN` (Personal Access Token) |
228
+ | **Get API Key** | GitLab → Preferences → Access Tokens |
229
+
230
+ **Install & Config:**
231
+ ```json
232
+ {
233
+ "gitlab": {
234
+ "command": "npx",
235
+ "args": ["-y", "@modelcontextprotocol/server-gitlab"],
236
+ "env": {
237
+ "GITLAB_PERSONAL_ACCESS_TOKEN": "${GITLAB_TOKEN}",
238
+ "GITLAB_API_URL": "https://gitlab.com"
239
+ }
240
+ }
241
+ }
242
+ ```
243
+
244
+ ---
245
+
246
+ ## 3. Databases
247
+
248
+ ---
249
+
250
+ ### PostgreSQL (Dev)
251
+
252
+ Read-write PostgreSQL access for development environments.
253
+
254
+ | Property | Value |
255
+ |---|---|
256
+ | **Package** | `@modelcontextprotocol/server-postgres` |
257
+ | **Website** | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
258
+ | **API Key** | **Required**: `DATABASE_URL_DEV` (connection string) |
259
+ | **GABBE Skill** | `data/db-migration.skill`, `data/sql-optimization.skill` |
260
+
261
+ **Install & Config:**
262
+ ```json
263
+ {
264
+ "postgres-dev": {
265
+ "command": "npx",
266
+ "args": ["-y", "@modelcontextprotocol/server-postgres"],
267
+ "env": {
268
+ "POSTGRES_CONNECTION_STRING": "${DATABASE_URL_DEV}"
269
+ }
270
+ }
271
+ }
272
+ ```
273
+
274
+ > [!CAUTION]
275
+ > **DEVELOPMENT ONLY** — never use read-write access in production. See `postgres-prod` for production config.
276
+
277
+ ---
278
+
279
+ ### PostgreSQL (Prod — Read-Only)
280
+
281
+ Read-only PostgreSQL for production schema introspection. Enable only when needed.
282
+
283
+ | Property | Value |
284
+ |---|---|
285
+ | **Package** | `@modelcontextprotocol/server-postgres` |
286
+ | **API Key** | **Required**: `DATABASE_URL_PROD_READONLY` |
287
+ | **Security** | Read-only access enforced by database user permissions |
288
+
289
+ **Install & Config:**
290
+ ```json
291
+ {
292
+ "postgres-prod": {
293
+ "command": "npx",
294
+ "args": ["-y", "@modelcontextprotocol/server-postgres"],
295
+ "env": {
296
+ "POSTGRES_CONNECTION_STRING": "${DATABASE_URL_PROD_READONLY}"
297
+ }
298
+ }
299
+ }
300
+ ```
301
+
302
+ ---
303
+
304
+ ### GreptimeDB
305
+
306
+ Time-series analytics and robust metrics logging.
307
+
308
+ | Property | Value |
309
+ |---|---|
310
+ | **Package** | `greptimedb-mcp-server` |
311
+ | **Website** | [greptime.com](https://greptime.com) |
312
+ | **API Key** | **Required**: `GREPTIME_HOST`, `GREPTIME_DB`, `GREPTIME_USERNAME`, `GREPTIME_PASSWORD` |
313
+
314
+ **Install & Config:**
315
+ ```json
316
+ {
317
+ "greptime": {
318
+ "command": "npx",
319
+ "args": ["-y", "greptimedb-mcp-server"],
320
+ "env": {
321
+ "GREPTIME_HOST": "${GREPTIME_HOST}",
322
+ "GREPTIME_DB": "${GREPTIME_DB}",
323
+ "GREPTIME_USERNAME": "${GREPTIME_USERNAME}",
324
+ "GREPTIME_PASSWORD": "${GREPTIME_PASSWORD}"
325
+ }
326
+ }
327
+ }
328
+ ```
329
+
330
+ ---
331
+
332
+ ### ClickHouse
333
+
334
+ Agentic OLAP and real-time reporting.
335
+
336
+ | Property | Value |
337
+ |---|---|
338
+ | **Package** | `mcp-clickhouse` |
339
+ | **Website** | [clickhouse.com](https://clickhouse.com) |
340
+ | **API Key** | **Required**: `CLICKHOUSE_URL`, `CLICKHOUSE_USER`, `CLICKHOUSE_PASSWORD` |
341
+
342
+ **Install & Config:**
343
+ ```json
344
+ {
345
+ "clickhouse": {
346
+ "command": "npx",
347
+ "args": ["-y", "mcp-clickhouse"],
348
+ "env": {
349
+ "CLICKHOUSE_URL": "${CLICKHOUSE_URL}",
350
+ "CLICKHOUSE_USER": "${CLICKHOUSE_USER}",
351
+ "CLICKHOUSE_PASSWORD": "${CLICKHOUSE_PASSWORD}"
352
+ }
353
+ }
354
+ }
355
+ ```
356
+
357
+ ---
358
+
359
+ ### MongoDB
360
+
361
+ MongoDB exploration, queries, and collection management.
362
+
363
+ | Property | Value |
364
+ |---|---|
365
+ | **Package** | `mongodb-lens` |
366
+ | **Website** | [mongodb.com](https://www.mongodb.com) |
367
+ | **API Key** | **Required**: `MONGODB_URI` (connection string) |
368
+
369
+ **Install & Config:**
370
+ ```json
371
+ {
372
+ "mongodb": {
373
+ "command": "npx",
374
+ "args": ["-y", "mongodb-lens"],
375
+ "env": {
376
+ "MONGODB_CONNECTION_STRING": "${MONGODB_URI}"
377
+ }
378
+ }
379
+ }
380
+ ```
381
+
382
+ ---
383
+
384
+ ### Redis
385
+
386
+ Redis key-value interaction and management.
387
+
388
+ | Property | Value |
389
+ |---|---|
390
+ | **Package** | `@modelcontextprotocol/server-redis` |
391
+ | **Website** | [redis.io](https://redis.io) |
392
+ | **API Key** | **Required**: `REDIS_URL` (e.g., `redis://localhost:6379`) |
393
+ | **GABBE Skill** | `ops/caching-strategy.skill` |
394
+
395
+ **Install & Config:**
396
+ ```json
397
+ {
398
+ "redis": {
399
+ "command": "npx",
400
+ "args": ["-y", "@modelcontextprotocol/server-redis"],
401
+ "env": {
402
+ "REDIS_URL": "${REDIS_URL}"
403
+ }
404
+ }
405
+ }
406
+ ```
407
+
408
+ ---
409
+
410
+ ### SQLite
411
+
412
+ SQLite database explorer (read-only recommended).
413
+
414
+ | Property | Value |
415
+ |---|---|
416
+ | **Package** | `sqlite-mcp` |
417
+ | **API Key** | None — local file path |
418
+
419
+ **Install & Config:**
420
+ ```json
421
+ {
422
+ "sqlite": {
423
+ "command": "npx",
424
+ "args": ["-y", "sqlite-mcp"],
425
+ "env": {
426
+ "SQLITE_PATH": "./database.sqlite"
427
+ }
428
+ }
429
+ }
430
+ ```
431
+
432
+ ---
433
+
434
+ ### DBHub (Universal)
435
+
436
+ Universal database client supporting MySQL, MariaDB, PostgreSQL, and SQL Server.
437
+
438
+ | Property | Value |
439
+ |---|---|
440
+ | **Package** | `@bytebase/dbhub` |
441
+ | **Website** | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
442
+ | **API Key** | None (uses local DB connections) |
443
+
444
+ **Install & Config:**
445
+ ```json
446
+ {
447
+ "dbhub": {
448
+ "command": "npx",
449
+ "args": ["-y", "@bytebase/dbhub"],
450
+ "env": {}
451
+ }
452
+ }
453
+ ```
454
+
455
+ ---
456
+
457
+ ## 4. Security & Code Quality
458
+
459
+ ---
460
+
461
+ ### Semgrep
462
+
463
+ SAST code scanning, security analysis with custom rules.
464
+
465
+ | Property | Value |
466
+ |---|---|
467
+ | **Package** | `semgrep_mcp` (Python) |
468
+ | **Website** | [semgrep.dev](https://semgrep.dev) |
469
+ | **API Key** | Optional: `SEMGREP_APP_TOKEN` |
470
+ | **Get API Key** | [semgrep.dev/settings/tokens](https://semgrep.dev/settings/tokens) |
471
+ | **Prerequisite** | `pip install semgrep` |
472
+ | **GABBE Skill** | `security/security-audit.skill` |
473
+
474
+ **Install & Config:**
475
+ ```bash
476
+ pip install semgrep
477
+ ```
478
+ ```json
479
+ {
480
+ "semgrep": {
481
+ "command": "python",
482
+ "args": ["-m", "semgrep_mcp"],
483
+ "env": {
484
+ "SEMGREP_APP_TOKEN": "${SEMGREP_APP_TOKEN}"
485
+ }
486
+ }
487
+ }
488
+ ```
489
+
490
+ ---
491
+
492
+ ### Time Complexity
493
+
494
+ Estimates Big-O time complexity via static analysis using tree-sitter. No code execution.
495
+
496
+ | Property | Value |
497
+ |---|---|
498
+ | **Package** | Local build — `time-complexity-mcp` |
499
+ | **Website** | [github.com/Luzgan/time-complexity-mcp](https://github.com/Luzgan/time-complexity-mcp) |
500
+ | **API Key** | None required |
501
+ | **Prerequisite** | Node.js 18+, `git` (for `analyze_github_repo`) |
502
+ | **GABBE Skill** | `coding/time-complexity.skill` |
503
+ | **GABBE Guide** | `guides/patterns/time-complexity-analysis.md` |
504
+ | **GABBE Template** | `templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md` |
505
+
506
+ **Install (from release — recommended):**
507
+ ```bash
508
+ # Download from https://github.com/Luzgan/time-complexity-mcp/releases/latest
509
+ tar xzf time-complexity-mcp-linux-x64-v*.tar.gz
510
+ ```
511
+
512
+ **Install (from source):**
513
+ ```bash
514
+ git clone https://github.com/Luzgan/time-complexity-mcp.git
515
+ cd time-complexity-mcp
516
+ npm install
517
+ npm run build
518
+ ```
519
+
520
+ **Config:**
521
+ ```json
522
+ {
523
+ "time-complexity": {
524
+ "command": "node",
525
+ "args": ["/absolute/path/to/time-complexity-mcp/dist/index.js"],
526
+ "env": {}
527
+ }
528
+ }
529
+ ```
530
+
531
+ **Tools provided:** `analyze_file`, `analyze_function`, `analyze_directory`, `analyze_github_repo`, `get_supported_languages`
532
+
533
+ **Supported languages:** JavaScript, TypeScript, Python, Java, Go, PHP, Dart, Kotlin
534
+
535
+ **Usage:**
536
+ ```
537
+ > "Scan src/ for complexity hotspots"
538
+ > "What's the complexity of the fibonacci function in recursion.py?"
539
+ ```
540
+
541
+ ---
542
+
543
+ ### Snyk
544
+
545
+ Vulnerability scanning for code and dependencies.
546
+
547
+ | Property | Value |
548
+ |---|---|
549
+ | **Package** | `snyk-mcp-server` |
550
+ | **Website** | [snyk.io](https://snyk.io) |
551
+ | **API Key** | **Required**: `SNYK_TOKEN` |
552
+ | **Get API Key** | [app.snyk.io/account](https://app.snyk.io/account) |
553
+ | **GABBE Skill** | `security/dependency-security.skill` |
554
+
555
+ **Install & Config:**
556
+ ```json
557
+ {
558
+ "snyk": {
559
+ "command": "npx",
560
+ "args": ["-y", "snyk-mcp-server"],
561
+ "env": {
562
+ "SNYK_TOKEN": "${SNYK_TOKEN}"
563
+ }
564
+ }
565
+ }
566
+ ```
567
+
568
+ ---
569
+
570
+ ### SonarQube
571
+
572
+ Code quality and security analysis.
573
+
574
+ | Property | Value |
575
+ |---|---|
576
+ | **Package** | `sonarqube-mcp` |
577
+ | **Website** | [sonarqube.org](https://www.sonarsource.com/products/sonarqube/) |
578
+ | **API Key** | **Required**: `SONAR_URL`, `SONAR_TOKEN` |
579
+
580
+ **Install & Config:**
581
+ ```json
582
+ {
583
+ "sonarqube": {
584
+ "command": "npx",
585
+ "args": ["-y", "sonarqube-mcp"],
586
+ "env": {
587
+ "SONAR_URL": "${SONAR_URL}",
588
+ "SONAR_TOKEN": "${SONAR_TOKEN}"
589
+ }
590
+ }
591
+ }
592
+ ```
593
+
594
+ ---
595
+
596
+ ### Gitleaks
597
+
598
+ Secret detection in git repositories. No API key required.
599
+
600
+ | Property | Value |
601
+ |---|---|
602
+ | **Package** | `gitleaks-mcp` |
603
+ | **Website** | [gitleaks.io](https://gitleaks.io) |
604
+ | **API Key** | None required |
605
+ | **GABBE Skill** | `security/secrets-management.skill` |
606
+
607
+ **Install & Config:**
608
+ ```json
609
+ {
610
+ "gitleaks": {
611
+ "command": "npx",
612
+ "args": ["-y", "gitleaks-mcp"],
613
+ "env": {}
614
+ }
615
+ }
616
+ ```
617
+
618
+ ---
619
+
620
+ ## 5. Observability & Monitoring
621
+
622
+ ---
623
+
624
+ ### Sentry
625
+
626
+ Error tracking, bug context, and performance issue correlation.
627
+
628
+ | Property | Value |
629
+ |---|---|
630
+ | **Package** | `@sentry/mcp-server` |
631
+ | **Website** | [sentry.io](https://sentry.io) |
632
+ | **API Key** | **Required**: `SENTRY_AUTH_TOKEN`, `SENTRY_ORG`, `SENTRY_PROJECT` |
633
+ | **Get API Key** | Sentry → Settings → API Keys |
634
+ | **GABBE Skill** | `ops/incident-response.skill` |
635
+
636
+ **Install & Config:**
637
+ ```json
638
+ {
639
+ "sentry": {
640
+ "command": "npx",
641
+ "args": ["-y", "@sentry/mcp-server"],
642
+ "env": {
643
+ "SENTRY_AUTH_TOKEN": "${SENTRY_AUTH_TOKEN}",
644
+ "SENTRY_ORG": "${SENTRY_ORG}",
645
+ "SENTRY_PROJECT": "${SENTRY_PROJECT}"
646
+ }
647
+ }
648
+ }
649
+ ```
650
+
651
+ ---
652
+
653
+ ### Datadog
654
+
655
+ Monitoring, alerts, and observability queries.
656
+
657
+ | Property | Value |
658
+ |---|---|
659
+ | **Package** | `@datadog/mcp-server` |
660
+ | **Website** | [datadoghq.com](https://www.datadoghq.com) |
661
+ | **API Key** | **Required**: `DATADOG_API_KEY`, `DATADOG_APP_KEY` |
662
+ | **Get API Key** | Datadog → Organization Settings → API Keys |
663
+
664
+ **Install & Config:**
665
+ ```json
666
+ {
667
+ "datadog": {
668
+ "command": "npx",
669
+ "args": ["-y", "@datadog/mcp-server"],
670
+ "env": {
671
+ "DD_API_KEY": "${DATADOG_API_KEY}",
672
+ "DD_APP_KEY": "${DATADOG_APP_KEY}"
673
+ }
674
+ }
675
+ }
676
+ ```
677
+
678
+ ---
679
+
680
+ ### Grafana
681
+
682
+ Dashboard search, datasource queries, and incident management.
683
+
684
+ | Property | Value |
685
+ |---|---|
686
+ | **Package** | `@grafana/mcp-server` |
687
+ | **Website** | [grafana.com](https://grafana.com) |
688
+ | **API Key** | **Required**: `GRAFANA_URL`, `GRAFANA_API_KEY` |
689
+ | **Get API Key** | Grafana → Administration → Service Accounts → Add Token |
690
+
691
+ **Install & Config:**
692
+ ```json
693
+ {
694
+ "grafana": {
695
+ "command": "npx",
696
+ "args": ["-y", "@grafana/mcp-server"],
697
+ "env": {
698
+ "GRAFANA_URL": "${GRAFANA_URL}",
699
+ "GRAFANA_API_KEY": "${GRAFANA_API_KEY}"
700
+ }
701
+ }
702
+ }
703
+ ```
704
+
705
+ ---
706
+
707
+ ## 6. Browser & Web
708
+
709
+ ---
710
+
711
+ ### Playwright
712
+
713
+ Browser automation for visual TDD and E2E testing.
714
+
715
+ | Property | Value |
716
+ |---|---|
717
+ | **Package** | `@playwright/mcp` |
718
+ | **Website** | [playwright.dev](https://playwright.dev) |
719
+ | **API Key** | None required |
720
+ | **GABBE Skill** | `coding/browser-tdd.skill` |
721
+
722
+ **Install & Config:**
723
+ ```json
724
+ {
725
+ "playwright": {
726
+ "command": "npx",
727
+ "args": ["@playwright/mcp", "--headless"],
728
+ "env": {}
729
+ }
730
+ }
731
+ ```
732
+
733
+ > [!NOTE]
734
+ > Use `--headless` for CI environments. Remove it for local debugging with a visible browser.
735
+
736
+ ---
737
+
738
+ ### Tavily
739
+
740
+ Real-time web search and content extraction. Alternative to Brave Search.
741
+
742
+ | Property | Value |
743
+ |---|---|
744
+ | **Package** | `tavily-mcp` |
745
+ | **Website** | [tavily.com](https://tavily.com) |
746
+ | **API Key** | **Required**: `TAVILY_API_KEY` |
747
+ | **Get API Key** | [tavily.com](https://tavily.com) (free tier available) |
748
+ | **GABBE Skill** | `core/research.skill` |
749
+
750
+ **Install & Config:**
751
+ ```json
752
+ {
753
+ "tavily": {
754
+ "command": "npx",
755
+ "args": ["-y", "tavily-mcp"],
756
+ "env": {
757
+ "TAVILY_API_KEY": "${TAVILY_API_KEY}"
758
+ }
759
+ }
760
+ }
761
+ ```
762
+
763
+ ---
764
+
765
+ ### Firecrawl
766
+
767
+ Turn websites into LLM-ready markdown. Website scraping and content extraction.
768
+
769
+ | Property | Value |
770
+ |---|---|
771
+ | **Package** | `firecrawl-mcp` |
772
+ | **Website** | [firecrawl.dev](https://firecrawl.dev) |
773
+ | **API Key** | **Required**: `FIRECRAWL_API_KEY` |
774
+
775
+ **Install & Config:**
776
+ ```json
777
+ {
778
+ "firecrawl": {
779
+ "command": "npx",
780
+ "args": ["-y", "firecrawl-mcp"],
781
+ "env": {
782
+ "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}"
783
+ }
784
+ }
785
+ }
786
+ ```
787
+
788
+ ---
789
+
790
+ ### Image Recognition
791
+
792
+ Vision API proxy for image analysis — sketch recognition, diagram interpretation, and OCR.
793
+
794
+ | Property | Value |
795
+ |---|---|
796
+ | **Package** | `mcp-image-recognition` |
797
+ | **Website** | [github.com/mario-andreschak/mcp-image-recognition](https://github.com/mario-andreschak/mcp-image-recognition) |
798
+ | **API Key** | **Required** (one of): `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, or `CLOUDFLARE_API_TOKEN` |
799
+ | **Optional** | Tesseract OCR installed for text extraction |
800
+ | **GABBE Skill** | `coding/sketch-to-diagram.skill` |
801
+
802
+ **Install & Config:**
803
+ ```json
804
+ {
805
+ "image-recognition": {
806
+ "command": "npx",
807
+ "args": ["-y", "mcp-image-recognition"],
808
+ "env": {
809
+ "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
810
+ }
811
+ }
812
+ }
813
+ ```
814
+
815
+ **Usage:**
816
+ ```
817
+ > "Analyze this whiteboard photo and describe all architecture elements"
818
+ > "Recognize the hand-drawn flowchart in sketch.jpg and convert to Mermaid"
819
+ ```
820
+
821
+ > [!WARNING]
822
+ > Images are sent to the configured external vision API for processing. Do not send sketches containing sensitive information (credentials, internal IPs) without user consent.
823
+
824
+ ---
825
+
826
+ ### DuckDuckGo
827
+
828
+ Privacy-focused web search. No API key required.
829
+
830
+ | Property | Value |
831
+ |---|---|
832
+ | **Package** | `duckduckgo-mcp-server` |
833
+ | **Website** | [duckduckgo.com](https://duckduckgo.com) |
834
+ | **API Key** | None required |
835
+
836
+ **Install & Config:**
837
+ ```json
838
+ {
839
+ "duckduckgo": {
840
+ "command": "npx",
841
+ "args": ["-y", "duckduckgo-mcp-server"],
842
+ "env": {}
843
+ }
844
+ }
845
+ ```
846
+
847
+ ---
848
+
849
+ ## 7. Cloud & Infrastructure
850
+
851
+ ---
852
+
853
+ ### Terraform
854
+
855
+ Agentic Infrastructure as Code (IaC) via HashiCorp.
856
+
857
+ | Property | Value |
858
+ |---|---|
859
+ | **Package** | `@hashicorp/terraform-mcp-server` |
860
+ | **Website** | [terraform.io](https://www.terraform.io) |
861
+ | **API Key** | Optional: `TERRAFORM_CLOUD_TOKEN` |
862
+ | **GABBE Skill** | `ops/infra-devops.skill` |
863
+
864
+ **Install & Config:**
865
+ ```json
866
+ {
867
+ "terraform": {
868
+ "command": "npx",
869
+ "args": ["-y", "@hashicorp/terraform-mcp-server"],
870
+ "env": {
871
+ "TERRAFORM_CLOUD_TOKEN": "${TERRAFORM_CLOUD_TOKEN}"
872
+ }
873
+ }
874
+ }
875
+ ```
876
+
877
+ ---
878
+
879
+ ### Docker
880
+
881
+ Docker daemon integration — manage containers, images, and read local logs.
882
+
883
+ | Property | Value |
884
+ |---|---|
885
+ | **Package** | `@docker/mcp-server` |
886
+ | **Website** | [docker.com](https://www.docker.com) |
887
+ | **API Key** | None (uses local Docker daemon) |
888
+ | **Prerequisite** | Docker Desktop or Docker Engine running |
889
+ | **GABBE Skill** | `ops/docker-dev.skill` |
890
+
891
+ **Install & Config:**
892
+ ```json
893
+ {
894
+ "docker": {
895
+ "command": "npx",
896
+ "args": ["-y", "@docker/mcp-server"],
897
+ "env": {}
898
+ }
899
+ }
900
+ ```
901
+
902
+ ---
903
+
904
+ ### AWS Core
905
+
906
+ AWS core services — documentation, CDK, Lambda.
907
+
908
+ | Property | Value |
909
+ |---|---|
910
+ | **Package** | `@aws/mcp-server-core` |
911
+ | **Website** | [aws.amazon.com](https://aws.amazon.com) |
912
+ | **API Key** | **Required**: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` |
913
+ | **GABBE Skill** | `ops/cloud-deploy.skill` |
914
+
915
+ **Install & Config:**
916
+ ```json
917
+ {
918
+ "aws-core": {
919
+ "command": "npx",
920
+ "args": ["-y", "@aws/mcp-server-core"],
921
+ "env": {
922
+ "AWS_ACCESS_KEY_ID": "${AWS_ACCESS_KEY_ID}",
923
+ "AWS_SECRET_ACCESS_KEY": "${AWS_SECRET_ACCESS_KEY}",
924
+ "AWS_REGION": "${AWS_REGION}"
925
+ }
926
+ }
927
+ }
928
+ ```
929
+
930
+ ---
931
+
932
+ ### Google Cloud
933
+
934
+ Google Cloud Platform — Firebase, Cloud Run, GKE, BigQuery.
935
+
936
+ | Property | Value |
937
+ |---|---|
938
+ | **Package** | `@googlecloud/mcp-server` |
939
+ | **Website** | [cloud.google.com](https://cloud.google.com) |
940
+ | **API Key** | **Required**: `GOOGLE_APPLICATION_CREDENTIALS` (path to service account JSON) |
941
+
942
+ **Install & Config:**
943
+ ```json
944
+ {
945
+ "google-cloud": {
946
+ "command": "npx",
947
+ "args": ["-y", "@googlecloud/mcp-server"],
948
+ "env": {
949
+ "GOOGLE_APPLICATION_CREDENTIALS": "${GOOGLE_APPLICATION_CREDENTIALS}"
950
+ }
951
+ }
952
+ }
953
+ ```
954
+
955
+ ---
956
+
957
+ ### Azure
958
+
959
+ Azure Resource management — Key Vault, CosmosDB, Azure Storage.
960
+
961
+ | Property | Value |
962
+ |---|---|
963
+ | **Package** | `@azure/mcp` |
964
+ | **Website** | [azure.microsoft.com](https://azure.microsoft.com) |
965
+ | **API Key** | **Required**: `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_TENANT_ID` |
966
+
967
+ **Install & Config:**
968
+ ```json
969
+ {
970
+ "azure": {
971
+ "command": "npx",
972
+ "args": ["-y", "@azure/mcp"],
973
+ "env": {
974
+ "AZURE_CLIENT_ID": "${AZURE_CLIENT_ID}",
975
+ "AZURE_CLIENT_SECRET": "${AZURE_CLIENT_SECRET}",
976
+ "AZURE_TENANT_ID": "${AZURE_TENANT_ID}"
977
+ }
978
+ }
979
+ }
980
+ ```
981
+
982
+ ---
983
+
984
+ ### Vercel
985
+
986
+ Vercel deployments, aliases, and serverless log integration.
987
+
988
+ | Property | Value |
989
+ |---|---|
990
+ | **Package** | `@vercel/mcp-server` |
991
+ | **Website** | [vercel.com](https://vercel.com) |
992
+ | **API Key** | **Required**: `VERCEL_API_TOKEN` |
993
+ | **Get API Key** | Vercel → Settings → Tokens |
994
+
995
+ **Install & Config:**
996
+ ```json
997
+ {
998
+ "vercel": {
999
+ "command": "npx",
1000
+ "args": ["-y", "@vercel/mcp-server"],
1001
+ "env": {
1002
+ "VERCEL_API_TOKEN": "${VERCEL_API_TOKEN}"
1003
+ }
1004
+ }
1005
+ }
1006
+ ```
1007
+
1008
+ ---
1009
+
1010
+ ### Kubernetes
1011
+
1012
+ Cluster state, pod logs, and deployment management.
1013
+
1014
+ | Property | Value |
1015
+ |---|---|
1016
+ | **Package** | `mcp-server-kubernetes` |
1017
+ | **Website** | [kubernetes.io](https://kubernetes.io) |
1018
+ | **API Key** | **Required**: `KUBECONFIG` (path to kubeconfig file) |
1019
+ | **GABBE Skill** | `ops/k8s-dev.skill` |
1020
+
1021
+ **Install & Config:**
1022
+ ```json
1023
+ {
1024
+ "kubernetes": {
1025
+ "command": "npx",
1026
+ "args": ["-y", "mcp-server-kubernetes"],
1027
+ "env": {
1028
+ "KUBECONFIG": "${KUBECONFIG}"
1029
+ }
1030
+ }
1031
+ }
1032
+ ```
1033
+
1034
+ > [!WARNING]
1035
+ > Use **read-only** kubeconfig for production clusters. Never allow exec, delete, or scale operations on production.
1036
+
1037
+ ---
1038
+
1039
+ ## 8. Design & Visual Architecture
1040
+
1041
+ ---
1042
+
1043
+ ### Figma
1044
+
1045
+ UI/UX semantic understanding, component specs, and design-to-code.
1046
+
1047
+ | Property | Value |
1048
+ |---|---|
1049
+ | **Package** | `@figma/mcp-server` |
1050
+ | **Website** | [figma.com](https://www.figma.com) |
1051
+ | **API Key** | **Required**: `FIGMA_ACCESS_TOKEN` |
1052
+ | **Get API Key** | Figma → Account Settings → Personal Access Tokens |
1053
+ | **GABBE Skill** | `coding/visual-design.skill`, `architecture/visual-whiteboarding.skill` |
1054
+
1055
+ **Install & Config:**
1056
+ ```json
1057
+ {
1058
+ "figma": {
1059
+ "command": "npx",
1060
+ "args": ["-y", "@figma/mcp-server"],
1061
+ "env": {
1062
+ "FIGMA_ACCESS_TOKEN": "${FIGMA_ACCESS_TOKEN}"
1063
+ }
1064
+ }
1065
+ }
1066
+ ```
1067
+
1068
+ ---
1069
+
1070
+ ### Draw.io
1071
+
1072
+ Programmatic generation and editing of C4, UML, and network diagrams.
1073
+
1074
+ | Property | Value |
1075
+ |---|---|
1076
+ | **Package** | `drawio-mcp-server` |
1077
+ | **Website** | [draw.io](https://www.drawio.com) |
1078
+ | **API Key** | None required |
1079
+ | **GABBE Skill** | `architecture/visual-whiteboarding.skill` |
1080
+
1081
+ **Install & Config:**
1082
+ ```json
1083
+ {
1084
+ "drawio": {
1085
+ "command": "npx",
1086
+ "args": ["-y", "drawio-mcp-server"],
1087
+ "env": {}
1088
+ }
1089
+ }
1090
+ ```
1091
+
1092
+ ---
1093
+
1094
+ ### Excalidraw
1095
+
1096
+ Create and manage Excalidraw diagrams — nodes, edges, and diagram state. Hand-drawn aesthetic.
1097
+
1098
+ | Property | Value |
1099
+ |---|---|
1100
+ | **Package** | `@cmd8/excalidraw-mcp` |
1101
+ | **Website** | [github.com/cmd8/excalidraw-mcp](https://github.com/cmd8/excalidraw-mcp) |
1102
+ | **API Key** | None required |
1103
+ | **Prerequisite** | Node.js 18+, local `.excalidraw` file path |
1104
+ | **GABBE Skill** | `coding/excalidraw.skill`, `coding/sketch-to-diagram.skill` |
1105
+
1106
+ **Install & Config:**
1107
+ ```json
1108
+ {
1109
+ "excalidraw": {
1110
+ "command": "npx",
1111
+ "args": ["-y", "@cmd8/excalidraw-mcp", "--diagram", "./docs/architecture.excalidraw"],
1112
+ "env": {}
1113
+ }
1114
+ }
1115
+ ```
1116
+
1117
+ **Tools:** `createNode`, `createEdge`, `deleteElement`, `getFullDiagramState`
1118
+
1119
+ **Usage:**
1120
+ ```
1121
+ > "Create an Excalidraw architecture diagram: API Gateway → Auth, Users, Orders"
1122
+ ```
1123
+
1124
+ > [!NOTE]
1125
+ > The `--diagram` flag specifies the target `.excalidraw` file. The file is created automatically if it doesn't exist. Excalidraw files are JSON-based and git-diffable.
1126
+
1127
+ ---
1128
+
1129
+ ### tldraw
1130
+
1131
+ Persistent visual canvas — create, manage, and search `.tldr` files for wireframing, prototyping, and visual scratchpads.
1132
+
1133
+ | Property | Value |
1134
+ |---|---|
1135
+ | **Package** | `@talhaorak/tldraw-mcp` |
1136
+ | **Website** | [github.com/talhaorak/tldraw-mcp](https://github.com/talhaorak/tldraw-mcp) |
1137
+ | **Canvas viewer** | [tldraw.com](https://www.tldraw.com) or VS Code tldraw extension |
1138
+ | **API Key** | None required |
1139
+ | **GABBE Skill** | `coding/tldraw-canvas.skill` |
1140
+
1141
+ **Install & Config:**
1142
+ ```json
1143
+ {
1144
+ "tldraw": {
1145
+ "command": "npx",
1146
+ "args": ["-y", "@talhaorak/tldraw-mcp"],
1147
+ "env": {}
1148
+ }
1149
+ }
1150
+ ```
1151
+
1152
+ **Tools (9):** `tldraw_create`, `tldraw_read`, `tldraw_write`, `tldraw_list`, `tldraw_search`, `tldraw_get_shapes`, `tldraw_add_shape`, `tldraw_update_shape`, `tldraw_delete_shape`
1153
+
1154
+ **Usage:**
1155
+ ```
1156
+ > "Create a tldraw wireframe for the login page with a header, form inputs, and submit button"
1157
+ > "Search all tldraw canvases for shapes mentioning 'auth'"
1158
+ ```
1159
+
1160
+ > [!TIP]
1161
+ > tldraw files are JSON-based and git-diffable. Use them as persistent visual notes that AI agents can read and search across.
1162
+
1163
+ ---
1164
+
1165
+ ### Miro
1166
+
1167
+ Read context from virtual whiteboards and sync architecture PRDs.
1168
+
1169
+ | Property | Value |
1170
+ |---|---|
1171
+ | **Package** | `@mirohq/miro-mcp-server` |
1172
+ | **Website** | [miro.com](https://miro.com) |
1173
+ | **API Key** | **Required**: `MIRO_ACCESS_TOKEN` |
1174
+ | **GABBE Skill** | `architecture/visual-whiteboarding.skill` |
1175
+
1176
+ **Install & Config:**
1177
+ ```json
1178
+ {
1179
+ "miro": {
1180
+ "command": "npx",
1181
+ "args": ["-y", "@mirohq/miro-mcp-server"],
1182
+ "env": {
1183
+ "MIRO_ACCESS_TOKEN": "${MIRO_ACCESS_TOKEN}"
1184
+ }
1185
+ }
1186
+ }
1187
+ ```
1188
+
1189
+ ---
1190
+
1191
+ ### Mermaid
1192
+
1193
+ Translate Mermaid/PlantUML syntax into SVG/PNG images.
1194
+
1195
+ | Property | Value |
1196
+ |---|---|
1197
+ | **Package** | `mermaid-mcp-server` |
1198
+ | **Website** | [mermaid.js.org](https://mermaid.js.org) |
1199
+ | **API Key** | None required |
1200
+ | **GABBE Skill** | `architecture/diagramming.skill` |
1201
+
1202
+ **Install & Config:**
1203
+ ```json
1204
+ {
1205
+ "mermaid": {
1206
+ "command": "npx",
1207
+ "args": ["-y", "mermaid-mcp-server"],
1208
+ "env": {}
1209
+ }
1210
+ }
1211
+ ```
1212
+
1213
+ ---
1214
+
1215
+ ## 9. Knowledge Bases & Vector Databases
1216
+
1217
+ ---
1218
+
1219
+ ### Qdrant
1220
+
1221
+ Semantic memory layer — vector search for long-term project knowledge.
1222
+
1223
+ | Property | Value |
1224
+ |---|---|
1225
+ | **Package** | `mcp-server-qdrant` |
1226
+ | **Website** | [qdrant.tech](https://qdrant.tech) |
1227
+ | **API Key** | **Required**: `QDRANT_URL`, `QDRANT_API_KEY` |
1228
+ | **GABBE Skill** | `core/knowledge-connect.skill` |
1229
+
1230
+ **Install & Config:**
1231
+ ```json
1232
+ {
1233
+ "qdrant": {
1234
+ "command": "npx",
1235
+ "args": ["-y", "mcp-server-qdrant"],
1236
+ "env": {
1237
+ "QDRANT_URL": "${QDRANT_URL}",
1238
+ "QDRANT_API_KEY": "${QDRANT_API_KEY}",
1239
+ "COLLECTION_NAME": "project-knowledge"
1240
+ }
1241
+ }
1242
+ }
1243
+ ```
1244
+
1245
+ ---
1246
+
1247
+ ### Pinecone
1248
+
1249
+ Managed vector database for semantic search.
1250
+
1251
+ | Property | Value |
1252
+ |---|---|
1253
+ | **Package** | `pinecone-mcp` |
1254
+ | **Website** | [pinecone.io](https://www.pinecone.io) |
1255
+ | **API Key** | **Required**: `PINECONE_API_KEY` |
1256
+
1257
+ **Install & Config:**
1258
+ ```json
1259
+ {
1260
+ "pinecone": {
1261
+ "command": "npx",
1262
+ "args": ["-y", "pinecone-mcp"],
1263
+ "env": {
1264
+ "PINECONE_API_KEY": "${PINECONE_API_KEY}"
1265
+ }
1266
+ }
1267
+ }
1268
+ ```
1269
+
1270
+ ---
1271
+
1272
+ ### ChromaDB
1273
+
1274
+ Open-source embedding database. No API key required for local mode.
1275
+
1276
+ | Property | Value |
1277
+ |---|---|
1278
+ | **Package** | `chromadb-mcp` |
1279
+ | **Website** | [trychroma.com](https://www.trychroma.com) |
1280
+ | **API Key** | None (local mode) |
1281
+
1282
+ **Install & Config:**
1283
+ ```json
1284
+ {
1285
+ "chroma": {
1286
+ "command": "npx",
1287
+ "args": ["-y", "chromadb-mcp"],
1288
+ "env": {}
1289
+ }
1290
+ }
1291
+ ```
1292
+
1293
+ ---
1294
+
1295
+ ### Weaviate
1296
+
1297
+ Vector search engine for semantic queries.
1298
+
1299
+ | Property | Value |
1300
+ |---|---|
1301
+ | **Package** | `weaviate-mcp` |
1302
+ | **Website** | [weaviate.io](https://weaviate.io) |
1303
+ | **API Key** | **Required**: `WEAVIATE_URL`, `WEAVIATE_API_KEY` |
1304
+
1305
+ **Install & Config:**
1306
+ ```json
1307
+ {
1308
+ "weaviate": {
1309
+ "command": "npx",
1310
+ "args": ["-y", "weaviate-mcp"],
1311
+ "env": {
1312
+ "WEAVIATE_URL": "${WEAVIATE_URL}",
1313
+ "WEAVIATE_API_KEY": "${WEAVIATE_API_KEY}"
1314
+ }
1315
+ }
1316
+ }
1317
+ ```
1318
+
1319
+ ---
1320
+
1321
+ ### Elasticsearch
1322
+
1323
+ Full-text search, log analysis, and knowledge base indexing.
1324
+
1325
+ | Property | Value |
1326
+ |---|---|
1327
+ | **Package** | `elasticsearch-mcp-server` |
1328
+ | **Website** | [elastic.co](https://www.elastic.co) |
1329
+ | **API Key** | **Required**: `ELASTICSEARCH_URL`, `ELASTICSEARCH_API_KEY` |
1330
+ | **GABBE Skill** | `security/log-analysis.skill` |
1331
+
1332
+ **Install & Config:**
1333
+ ```json
1334
+ {
1335
+ "elasticsearch": {
1336
+ "command": "npx",
1337
+ "args": ["-y", "elasticsearch-mcp-server"],
1338
+ "env": {
1339
+ "ELASTICSEARCH_URL": "${ELASTICSEARCH_URL}",
1340
+ "ELASTICSEARCH_API_KEY": "${ELASTICSEARCH_API_KEY}"
1341
+ }
1342
+ }
1343
+ }
1344
+ ```
1345
+
1346
+ ---
1347
+
1348
+ ## 10. Project Management & Collaboration
1349
+
1350
+ ---
1351
+
1352
+ ### Jira
1353
+
1354
+ Jira Cloud task interaction — read and update tickets.
1355
+
1356
+ | Property | Value |
1357
+ |---|---|
1358
+ | **Package** | `@aashari/mcp-server-atlassian-jira` |
1359
+ | **Website** | [atlassian.com/jira](https://www.atlassian.com/software/jira) |
1360
+ | **API Key** | **Required**: `JIRA_SITE`, `JIRA_EMAIL`, `JIRA_API_TOKEN` |
1361
+ | **Get API Key** | [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens) |
1362
+
1363
+ **Install & Config:**
1364
+ ```json
1365
+ {
1366
+ "jira": {
1367
+ "command": "npx",
1368
+ "args": ["-y", "@aashari/mcp-server-atlassian-jira"],
1369
+ "env": {
1370
+ "ATLASSIAN_SITE_NAME": "${JIRA_SITE}",
1371
+ "ATLASSIAN_USER_EMAIL": "${JIRA_EMAIL}",
1372
+ "ATLASSIAN_API_TOKEN": "${JIRA_API_TOKEN}"
1373
+ }
1374
+ }
1375
+ }
1376
+ ```
1377
+
1378
+ ---
1379
+
1380
+ ### Confluence
1381
+
1382
+ Confluence pages and spaces.
1383
+
1384
+ | Property | Value |
1385
+ |---|---|
1386
+ | **Package** | `@modelcontextprotocol/server-confluence` |
1387
+ | **Website** | [atlassian.com/confluence](https://www.atlassian.com/software/confluence) |
1388
+ | **API Key** | **Required**: `CONFLUENCE_URL`, `CONFLUENCE_EMAIL`, `CONFLUENCE_TOKEN` |
1389
+
1390
+ **Install & Config:**
1391
+ ```json
1392
+ {
1393
+ "confluence": {
1394
+ "command": "npx",
1395
+ "args": ["-y", "@modelcontextprotocol/server-confluence"],
1396
+ "env": {
1397
+ "ATLASSIAN_URL": "${CONFLUENCE_URL}",
1398
+ "ATLASSIAN_USERNAME": "${CONFLUENCE_EMAIL}",
1399
+ "ATLASSIAN_API_TOKEN": "${CONFLUENCE_TOKEN}"
1400
+ }
1401
+ }
1402
+ }
1403
+ ```
1404
+
1405
+ ---
1406
+
1407
+ ### Notion
1408
+
1409
+ Notion workspace access — pages, databases, docs.
1410
+
1411
+ | Property | Value |
1412
+ |---|---|
1413
+ | **Package** | `@notionhq/notion-mcp-server` |
1414
+ | **Website** | [notion.so](https://www.notion.so) |
1415
+ | **API Key** | **Required**: `NOTION_TOKEN` (internal integration token) |
1416
+ | **Get API Key** | [notion.so/my-integrations](https://www.notion.so/my-integrations) |
1417
+
1418
+ **Install & Config:**
1419
+ ```json
1420
+ {
1421
+ "notion": {
1422
+ "command": "npx",
1423
+ "args": ["-y", "@notionhq/notion-mcp-server"],
1424
+ "env": {
1425
+ "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ${NOTION_TOKEN}\"}"
1426
+ }
1427
+ }
1428
+ }
1429
+ ```
1430
+
1431
+ ---
1432
+
1433
+ ### Linear
1434
+
1435
+ Linear issue tracking and project management.
1436
+
1437
+ | Property | Value |
1438
+ |---|---|
1439
+ | **Package** | `linear-mcp-server` |
1440
+ | **Website** | [linear.app](https://linear.app) |
1441
+ | **API Key** | **Required**: `LINEAR_API_KEY` |
1442
+ | **Get API Key** | Linear → Settings → API → Personal API Keys |
1443
+
1444
+ **Install & Config:**
1445
+ ```json
1446
+ {
1447
+ "linear": {
1448
+ "command": "npx",
1449
+ "args": ["-y", "linear-mcp-server"],
1450
+ "env": {
1451
+ "LINEAR_API_KEY": "${LINEAR_API_KEY}"
1452
+ }
1453
+ }
1454
+ }
1455
+ ```
1456
+
1457
+ ---
1458
+
1459
+ ### Slack
1460
+
1461
+ Workspace channels, DMs, and message history.
1462
+
1463
+ | Property | Value |
1464
+ |---|---|
1465
+ | **Package** | `slack-mcp-server` |
1466
+ | **Website** | [api.slack.com](https://api.slack.com) |
1467
+ | **API Key** | **Required**: `SLACK_BOT_TOKEN`, `SLACK_TEAM_ID` |
1468
+ | **Get API Key** | [api.slack.com/apps](https://api.slack.com/apps) → Create App → Bot Token |
1469
+
1470
+ **Install & Config:**
1471
+ ```json
1472
+ {
1473
+ "slack": {
1474
+ "command": "npx",
1475
+ "args": ["-y", "slack-mcp-server"],
1476
+ "env": {
1477
+ "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}",
1478
+ "SLACK_TEAM_ID": "${SLACK_TEAM_ID}"
1479
+ }
1480
+ }
1481
+ }
1482
+ ```
1483
+
1484
+ ---
1485
+
1486
+ ## 11. API Introspection & Knowledge
1487
+
1488
+ ---
1489
+
1490
+ ### GraphQL
1491
+
1492
+ GraphQL schema introspection, query validation, and documentation.
1493
+
1494
+ | Property | Value |
1495
+ |---|---|
1496
+ | **Package** | `graphql-mcp-server` |
1497
+ | **API Key** | **Required**: `GRAPHQL_ENDPOINT`, Optional: `GRAPHQL_TOKEN` |
1498
+ | **GABBE Skill** | `architecture/graphql-schema.skill` |
1499
+
1500
+ **Install & Config:**
1501
+ ```json
1502
+ {
1503
+ "graphql": {
1504
+ "command": "npx",
1505
+ "args": ["-y", "graphql-mcp-server"],
1506
+ "env": {
1507
+ "GRAPHQL_ENDPOINT": "${GRAPHQL_ENDPOINT}",
1508
+ "GRAPHQL_HEADERS": "{\"Authorization\": \"Bearer ${GRAPHQL_TOKEN}\"}"
1509
+ }
1510
+ }
1511
+ }
1512
+ ```
1513
+
1514
+ ---
1515
+
1516
+ ### OpenAPI
1517
+
1518
+ Load and query any OpenAPI/Swagger specification for API exploration.
1519
+
1520
+ | Property | Value |
1521
+ |---|---|
1522
+ | **Package** | `openapi-mcp-server` |
1523
+ | **API Key** | None — requires `OPENAPI_SPEC_URL` (path or URL to spec) |
1524
+ | **GABBE Skill** | `architecture/api-design.skill` |
1525
+
1526
+ **Install & Config:**
1527
+ ```json
1528
+ {
1529
+ "openapi": {
1530
+ "command": "npx",
1531
+ "args": ["-y", "openapi-mcp-server"],
1532
+ "env": {
1533
+ "OPENAPI_SPEC_URL": "${OPENAPI_SPEC_URL}"
1534
+ }
1535
+ }
1536
+ }
1537
+ ```
1538
+
1539
+ ---
1540
+
1541
+ ### Shell
1542
+
1543
+ Execute shell commands for local build, test, and system introspection.
1544
+
1545
+ | Property | Value |
1546
+ |---|---|
1547
+ | **Package** | `@anthropic/mcp-server-shell` |
1548
+ | **API Key** | None required |
1549
+
1550
+ **Install & Config:**
1551
+ ```json
1552
+ {
1553
+ "shell": {
1554
+ "command": "npx",
1555
+ "args": ["-y", "@anthropic/mcp-server-shell"],
1556
+ "env": {}
1557
+ }
1558
+ }
1559
+ ```
1560
+
1561
+ > [!CAUTION]
1562
+ > **DEVELOPMENT ONLY** — restrict to project directory. Never enable in production environments. Risk of arbitrary command execution.
1563
+
1564
+ ---
1565
+
1566
+ ### Jupyter
1567
+
1568
+ Execute Python code in Jupyter notebooks.
1569
+
1570
+ | Property | Value |
1571
+ |---|---|
1572
+ | **Package** | `jupyter-mcp-server` |
1573
+ | **Prerequisite** | Jupyter installed locally |
1574
+ | **API Key** | None required |
1575
+
1576
+ **Install & Config:**
1577
+ ```json
1578
+ {
1579
+ "jupyter": {
1580
+ "command": "npx",
1581
+ "args": ["-y", "jupyter-mcp-server"],
1582
+ "env": {}
1583
+ }
1584
+ }
1585
+ ```
1586
+
1587
+ ---
1588
+
1589
+ ## 12. Payments & Automation
1590
+
1591
+ ---
1592
+
1593
+ ### Stripe
1594
+
1595
+ Search and manage Stripe payment resources.
1596
+
1597
+ | Property | Value |
1598
+ |---|---|
1599
+ | **Package** | `@stripe/mcp` |
1600
+ | **Website** | [stripe.com](https://stripe.com) |
1601
+ | **API Key** | **Required**: `STRIPE_SECRET_KEY` |
1602
+ | **Get API Key** | Stripe Dashboard → Developers → API Keys |
1603
+
1604
+ **Install & Config:**
1605
+ ```json
1606
+ {
1607
+ "stripe": {
1608
+ "command": "npx",
1609
+ "args": ["-y", "@stripe/mcp"],
1610
+ "env": {
1611
+ "STRIPE_API_KEY": "${STRIPE_SECRET_KEY}"
1612
+ }
1613
+ }
1614
+ }
1615
+ ```
1616
+
1617
+ > [!WARNING]
1618
+ > Use **test mode** keys during development. Never expose live secret keys in config files.
1619
+
1620
+ ---
1621
+
1622
+ ### Zapier
1623
+
1624
+ Connect to 6,000+ apps via Zapier Natural Language Actions.
1625
+
1626
+ | Property | Value |
1627
+ |---|---|
1628
+ | **Package** | `@zapier/mcp-server` |
1629
+ | **Website** | [zapier.com](https://zapier.com) |
1630
+ | **API Key** | **Required**: `ZAPIER_NLA_API_KEY` |
1631
+ | **Get API Key** | [nla.zapier.com/credentials](https://nla.zapier.com/credentials) |
1632
+
1633
+ **Install & Config:**
1634
+ ```json
1635
+ {
1636
+ "zapier": {
1637
+ "command": "npx",
1638
+ "args": ["-y", "@zapier/mcp-server"],
1639
+ "env": {
1640
+ "ZAPIER_NLA_API_KEY": "${ZAPIER_NLA_API_KEY}"
1641
+ }
1642
+ }
1643
+ }
1644
+ ```
1645
+
1646
+ ---
1647
+
1648
+ ## 13. Security Rules & Best Practices
1649
+
1650
+ These rules apply to all MCP server configurations:
1651
+
1652
+ | Rule | Description |
1653
+ |---|---|
1654
+ | **Production databases** | Read-only access only — use a dedicated read-only DB user |
1655
+ | **Development databases** | Read-write allowed — never point dev config at a production DB |
1656
+ | **Secrets policy** | All credentials via environment variables — never hardcoded |
1657
+ | **File system** | Restrict to project directory only — no access to `/etc`, `/home`, system dirs |
1658
+ | **Kubernetes (prod)** | Read-only mode only — no exec, no delete, no scale |
1659
+ | **Browser CI** | Headless mode only for CI — headed mode for local debugging only |
1660
+ | **Shell** | Development only — never enable in production |
1661
+
1662
+ ---
1663
+
1664
+ ## 14. Environment Variables Summary
1665
+
1666
+ All credentials should be set as environment variables in your shell profile or `.env` file.
1667
+
1668
+ ### Essential (recommended for every project)
1669
+ | Variable | Source | Required By |
1670
+ |---|---|---|
1671
+ | `BRAVE_API_KEY` | [api.search.brave.com/register](https://api.search.brave.com/register) | Brave Search |
1672
+ | `GITHUB_TOKEN` | GitHub → Settings → Developer Settings → PAT | GitHub MCP |
1673
+
1674
+ ### Databases
1675
+ | Variable | Description | Required By |
1676
+ |---|---|---|
1677
+ | `DATABASE_URL_DEV` | PostgreSQL connection string (dev) | PostgreSQL Dev |
1678
+ | `DATABASE_URL_PROD_READONLY` | PostgreSQL read-only connection (prod) | PostgreSQL Prod |
1679
+ | `MONGODB_URI` | MongoDB connection string | MongoDB |
1680
+ | `REDIS_URL` | Redis URL (e.g., `redis://localhost:6379`) | Redis |
1681
+
1682
+ ### Security & Code Quality
1683
+ | Variable | Source | Required By |
1684
+ |---|---|---|
1685
+ | `SEMGREP_APP_TOKEN` | [semgrep.dev/settings/tokens](https://semgrep.dev/settings/tokens) | Semgrep |
1686
+ | `SNYK_TOKEN` | [app.snyk.io/account](https://app.snyk.io/account) | Snyk |
1687
+ | `SONAR_URL` / `SONAR_TOKEN` | SonarQube instance | SonarQube |
1688
+
1689
+ ### Observability
1690
+ | Variable | Source | Required By |
1691
+ |---|---|---|
1692
+ | `SENTRY_AUTH_TOKEN` | Sentry → Settings → API Keys | Sentry |
1693
+ | `SENTRY_ORG` / `SENTRY_PROJECT` | Sentry organization settings | Sentry |
1694
+ | `DATADOG_API_KEY` / `DATADOG_APP_KEY` | Datadog → Org Settings | Datadog |
1695
+ | `GRAFANA_URL` / `GRAFANA_API_KEY` | Grafana administration | Grafana |
1696
+ | `TAVILY_API_KEY` | [tavily.com](https://tavily.com) | Tavily |
1697
+
1698
+ ### Cloud
1699
+ | Variable | Description | Required By |
1700
+ |---|---|---|
1701
+ | `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY` / `AWS_REGION` | AWS IAM credentials | AWS Core |
1702
+ | `GOOGLE_APPLICATION_CREDENTIALS` | Path to GCP service account JSON | Google Cloud |
1703
+ | `AZURE_CLIENT_ID` / `AZURE_CLIENT_SECRET` / `AZURE_TENANT_ID` | Azure AD app registration | Azure |
1704
+ | `VERCEL_API_TOKEN` | Vercel token | Vercel |
1705
+ | `TERRAFORM_CLOUD_TOKEN` | Terraform Cloud | Terraform |
1706
+
1707
+ ### Collaboration
1708
+ | Variable | Source | Required By |
1709
+ |---|---|---|
1710
+ | `GITLAB_TOKEN` | GitLab → Preferences → Access Tokens | GitLab |
1711
+ | `JIRA_SITE` / `JIRA_EMAIL` / `JIRA_API_TOKEN` | Atlassian API tokens | Jira |
1712
+ | `CONFLUENCE_URL` / `CONFLUENCE_EMAIL` / `CONFLUENCE_TOKEN` | Atlassian | Confluence |
1713
+ | `NOTION_TOKEN` | [notion.so/my-integrations](https://www.notion.so/my-integrations) | Notion |
1714
+ | `LINEAR_API_KEY` | Linear → Settings → API | Linear |
1715
+ | `SLACK_BOT_TOKEN` / `SLACK_TEAM_ID` | [api.slack.com/apps](https://api.slack.com/apps) | Slack |
1716
+
1717
+ ### Design & Visual
1718
+ | Variable | Source | Required By |
1719
+ |---|---|---|
1720
+ | `FIGMA_ACCESS_TOKEN` | Figma → Account Settings | Figma |
1721
+ | `MIRO_ACCESS_TOKEN` | Miro developer portal | Miro |
1722
+
1723
+ ### Vector Databases
1724
+ | Variable | Description | Required By |
1725
+ |---|---|---|
1726
+ | `QDRANT_URL` / `QDRANT_API_KEY` | Qdrant instance | Qdrant |
1727
+ | `PINECONE_API_KEY` | Pinecone console | Pinecone |
1728
+ | `WEAVIATE_URL` / `WEAVIATE_API_KEY` | Weaviate instance | Weaviate |
1729
+ | `ELASTICSEARCH_URL` / `ELASTICSEARCH_API_KEY` | Elastic deployment | Elasticsearch |
1730
+
1731
+ ### Payments & Automation
1732
+ | Variable | Source | Required By |
1733
+ |---|---|---|
1734
+ | `STRIPE_SECRET_KEY` | Stripe Dashboard → Developers | Stripe |
1735
+ | `ZAPIER_NLA_API_KEY` | [nla.zapier.com/credentials](https://nla.zapier.com/credentials) | Zapier |
1736
+ | `FIRECRAWL_API_KEY` | firecrawl.dev | Firecrawl |
1737
+
1738
+ ---
1739
+
1740
+ *See also: `agents/templates/core/MCP_CONFIG_TEMPLATE.json` for the raw configuration template.*
1741
+ *See also: [README.md](../README.md) for the Essential MCP Servers quick reference.*
1742
+ *See also: [README_FULL.md](README_FULL.md) for the full MCP coverage matrix.*
1743
+
1744
+ ---
1745
+
1746
+ ## SWEBOK v4 Priority Map
1747
+
1748
+ A lifecycle-oriented view of the highest-value, self-hostable/free-tier MCP servers,
1749
+ mapped to the SWEBOK v4 knowledge areas. Most run locally via Docker or Node so
1750
+ credentials never leave the host. Servers marked **(new in v1.0)** were added to
1751
+ `MCP_CONFIG_TEMPLATE.json` as opt-in (`_enabled: false`) entries.
1752
+
1753
+ | SWEBOK area | Priority MCP servers | GABBE tie-in |
1754
+ |---|---|---|
1755
+ | **Requirements & Design** | `figma`, `notion`, `obsidian` (new), `knowledge-graph-memory` (new) | S00–S03; `knowledge-connect.skill`, ADR/spec search; persistent semantic memory prevents architectural-decision drift |
1756
+ | **Construction & Architecture** | `github`, `supabase` (new), `postgres-dev`/`postgres-prod`, `mongodb`, `aws-core`, `azure`, `kubernetes`, `docker` | S05; direct schema/query execution instead of guessed SQL |
1757
+ | **Testing & Quality** | `sentry`, `snyk`, `semgrep`, `mcp-evals` (new), `mcp-chaos-rig` (new) | S06–S07; `mcp-evals` ↔ `eval-driven-development.skill`; `mcp-chaos-rig` ↔ `chaos-fault-injection.skill` + `gabbe verify --chaos` |
1758
+ | **Maintenance & Config Mgmt** | `pagerduty` (new), `cloudflare` (new), `vercel`, `gitlab` | S11–S13 Day-2; on-call automation, edge deploy logs |
1759
+ | **Eng. Management & Economics** | `linear`, `jira`, `confluence`, `slack`, `discord` (new), `stripe` | management + software economics; comms triage, billing/churn |
1760
+ | **Computing & Foundations** | `firecrawl`, `qdrant`, `chroma`/`weaviate`/`pinecone`, `google-genai-toolbox` (new), `context7`, `sequential-thinking` | research, RAG long-term memory, foundational data access |
1761
+
1762
+ **Deployment note:** the vast majority of these run locally via Docker or Node, so API
1763
+ keys/credentials stay on the host unless explicitly routed through an enterprise gateway.
1764
+ All new entries are opt-in — enable per project by setting `_enabled: true` and the listed
1765
+ env vars.