{
  "markdown": "# Dojo Genesis MCP Server\n\nThe methodology layer for Claude Code -- the first MCP server that makes Claude measurably better at software development decisions by encoding 99 first-party working methods across 10 behavioral plugins as active cognitive scaffolds.\n\nEvery other MCP server gives Claude more data. This one gives Claude better *methods*.\n\n<!-- Badges -->\n[![CI](https://github.com/DojoGenesis/mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/DojoGenesis/mcp/actions/workflows/ci.yml)\n[![Go](https://img.shields.io/badge/Go-1.23+-00ADD8?logo=go&logoColor=white)](https://go.dev)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)\n[![LobeHub](https://lobehub.com/badge/mcp/dojogenesis-mcp-server)](https://lobehub.com/mcp/dojogenesis-mcp-server)\n\n---\n\n## Quick Install\n\n### Claude Code\n\nAdd to your project's `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"dojo\": {\n      \"command\": \"/path/to/dojo-mcp-server\",\n      \"env\": {\n        \"DOJO_SKILLS_PATH\": \"/path/to/CoworkPluginsByDojoGenesis\",\n        \"DOJO_ADR_PATH\": \"./decisions\"\n      }\n    }\n  }\n}\n```\n\nOr using Docker:\n\n```json\n{\n  \"mcpServers\": {\n    \"dojo\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"ghcr.io/dojogenesis/mcp-server:latest\"]\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"dojo\": {\n      \"command\": \"/path/to/dojo-mcp-server\",\n      \"env\": {\n        \"DOJO_SKILLS_PATH\": \"/path/to/CoworkPluginsByDojoGenesis\",\n        \"DOJO_ADR_PATH\": \"./decisions\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## What's Included\n\n### Tools (28)\n\n| Group | Tools |\n|-------|-------|\n| Methodology | `dojo_scout`, `dojo_invoke_skill`, `dojo_search_skills`, `dojo_list_skills`, `dojo_apply_seed`, `dojo_reflect` |\n| Decisions | `dojo_log_decision` (writes ADR markdown to `DOJO_ADR_PATH`) |\n| Gateway memory | `dojo_memory_list`, `dojo_memory_store`, `dojo_memory_search` (gateway session memory) |\n| **Memory Hub** | `dojo_search_memory`, `dojo_get_memory`, `dojo_recent_memories` — read-only Postgres mirror of the institutional memory (`DOJO_MEMORY_DB_URL`) |\n| **Unified fetch** | `dojo_fetch` — one tool to search AND fetch across memory hub + skills + ADRs + seeds (typed ids: `memory:slug`, `skill:name`, `adr:file.md`, `seed:name`) |\n| Seeds | `dojo_seed_list`, `dojo_seed_create`, `dojo_seed_search` |\n| Agents² | `dojo_agent_list`, `dojo_agent_dispatch`², `dojo_agent_chat`² |\n| **Dispatch²** | `dojo_dispatch`² — prompt → LLM through the gateway |\n| Project | `dojo_project_status`, `dojo_project_track`, `dojo_project_decision` |\n| Disposition | `dojo_disposition_list`, `dojo_disposition_set` |\n| Craft | `dojo_converge`, `dojo_health` |\n\n² **Dispatch-class** — spends LLM provider budget through the gateway. In HTTP\nmode these require a dispatch-enabled API key and are rate limited per key;\n`dojo_scout`'s LLM path degrades to its offline scaffold for non-dispatch keys.\n\n### Skills (99 from CoworkPlugins, 35 bundled)\n\nSkills are complete, battle-tested methodology workflows loaded from SKILL.md files at startup. When `DOJO_SKILLS_PATH` is set, all 99 first-party CoworkPlugins skills are available. Without it, 35 key skills across 7 plugins are embedded in the binary via `go:embed`.\n\n**Bundled plugins and skills:**\n\n| Plugin | Skills |\n|--------|--------|\n| `agent-orchestration` | agent-teaching, decision-propagation, handoff-protocol, workflow-router, workspace-navigation |\n| `continuous-learning` | debugging, project-exploration, research-modes, research-synthesis, retrospective, web-research-external |\n| `skill-forge` | mcp-cloudflare-builder, mcp-server-builder, process-extraction, skill-audit, skill-creation, skill-maintenance |\n| `specification-driven-development` | context-ingestion, frontend-from-backend, implementation-prompt, parallel-tracks, pre-implementation-checklist, release-specification |\n| `strategic-thinking` | iterative-scouting, multi-surface-strategy, product-positioning, strategic-scout |\n| `system-health` | documentation-audit, health-audit, semantic-clusters, status-writing |\n| `wisdom-garden` | compression-ritual, memory-garden, seed-extraction, seed-library |\n\n### Seed Patches (20)\n\nSeeds are reusable thinking patterns drawn from across the Dojo ecosystem.\n\n**Dojo Genesis (Core)**\n| Seed | Description |\n|------|-------------|\n| `three_tiered_governance` | Three-tiered governance framework: Strategic, Tactical, Operational. |\n| `harness_trace` | Nested JSON trace log for complete agent session traceability. |\n| `context_iceberg` | 4-tier context management system (hot/warm/cold/pruned). |\n| `agent_connect` | Routing-first agent architecture with a single supervisor. |\n| `go_live_bundles` | Lightweight deployment packages pairing artifacts with approval evidence. |\n| `cost_guard` | Budget for the full 5-10x context iceberg multiplier. |\n| `safety_switch` | Users must remain in control -- no autopilot on sensitive operations. |\n| `implicit_perspective_extraction` | Extract implicit perspectives from user queries without enumeration. |\n| `mode_based_complexity_gating` | Route to local or cloud models based on mode complexity. |\n| `shared_infrastructure` | Build once, reuse everywhere -- central implementations. |\n\n**AROMA & Serenity Valley**\n| Seed | Description |\n|------|-------------|\n| `sanctuary_architecture` | Design digital spaces for being, not just doing. |\n| `pace_of_understanding` | Move slow to move fast; learn without extraction. |\n| `lineage_transmission` | Honor sources, trace influence, celebrate collaboration. |\n| `graceful_failure` | Permission to not know, change your mind, and ask for help. |\n| `local_first_liberation` | Local-first architecture for agent autonomy and user sovereignty. |\n| `the_onsen_pattern` | Rest as critical practice for sustainable performance. |\n| `collaborative_calibration` | Norms for peer-to-peer learning and explicit teaching. |\n| `transparent_intelligence` | Reveal internal state, admit uncertainty, make learning visible. |\n| `inter_acceptance` | Accept yourself through the compassionate eyes of another. |\n| `radical_freedom` | Agency and the power to choose your response within constraints. |\n\n### Resources\n\nDocumentation resources accessible via MCP resource URIs:\n\n- `dojo://resources/{name}` -- 8 documentation resources (AROMA philosophy, EIT principles, etc.)\n- `dojo://seeds/{name}` -- 20 seed patches\n- `dojo://skills/{plugin}/{name}` -- All loaded skills\n\n---\n\n## Configuration\n\n| Env Var | Default | Description |\n|---------|---------|-------------|\n| `DOJO_SKILLS_PATH` | (bundled fallback) | Path to CoworkPlugins root directory containing `plugins/` |\n| `DOJO_ADR_PATH` | `./decisions` | Directory where `dojo_log_decision` writes ADR files |\n| `DOJO_GATEWAY_URL` | `http://localhost:7340` | Dojo AgenticGateway base URL |\n| `DOJO_GATEWAY_TOKEN` | (unset) | Bearer token for the gateway, if it requires one |\n| `DOJO_MEMORY_DB_URL` | (unset → hub tools disabled) | Postgres DSN for the Memory Hub (URL or keyword form; use the SELECT-only role) |\n| `DOJO_HTTP_ADDR` | (unset → stdio) | Opt into HTTP mode, e.g. `:8091` |\n| `DOJO_MCP_API_KEYS` | (unset) | HTTP mode only: comma-separated `label:key` pairs (individually revocable) |\n| `DOJO_DISPATCH_ALLOWED_LABELS` | (unset → none) | Key labels allowed to run dispatch-class tools |\n| `DOJO_DISPATCH_RATE_PER_MIN` | `6` | Per-label rate limit for dispatch-class tools |\n\nThe server works out of the box with zero configuration (bundled skills, default ADR path, stdio).\n\n---\n\n## HTTP Mode (public endpoint)\n\nSetting `DOJO_HTTP_ADDR` serves MCP streamable-HTTP instead of stdio:\n\n- `POST/GET /mcp` — the MCP endpoint, Bearer-key required\n  (`Authorization: Bearer <key>`). Keyless or wrong-key requests get 401.\n- `/mcp/k/<key>` — same endpoint for clients that cannot send custom\n  headers; the key is redacted in logs.\n- `GET /health` — unauthenticated liveness (status + version only).\n\nThe server refuses to start in HTTP mode without a valid, non-empty\n`DOJO_MCP_API_KEYS`. Every tool call is logged as\n`tool_call tool=… key=<label> dur_ms=… outcome=…` — labels only, never key\nmaterial, never payloads.\n\n```bash\nDOJO_HTTP_ADDR=:8091 \\\nDOJO_MCP_API_KEYS=\"win:$(openssl rand -hex 32)\" \\\n./dojo-mcp-server\n\ncurl -s localhost:8091/health\ncurl -s -X POST localhost:8091/mcp \\\n  -H \"Authorization: Bearer <key>\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"curl\",\"version\":\"0\"}}}'\n```\n\nClient wiring (Claude Code): `claude mcp add --transport http dojo-remote\nhttps://<host>/mcp --header \"Authorization: Bearer <key>\"`.\n\nDeployment notes: ingress is expected to be a Cloudflare tunnel (no host\nports); pin the container image **by digest** so auto-pull never\nsurprise-deploys a new public surface. Image publishing:\n`.github/workflows/docker-publish.yml` → `ghcr.io/dojogenesis/mcp`\n(supersedes the old manually-pushed `mcpbydojogenesis` image).\n\n---\n\n## Building from Source\n\n```bash\ngit clone https://github.com/DojoGenesis/mcp.git\ncd mcp\n\n# Build\ngo build -o dojo-mcp-server ./cmd/server\n\n# Run\n./dojo-mcp-server\n\n# Test\ngo test -race -v ./...\n```\n\nRequires Go 1.23 or later.\n\n## Docker\n\n```bash\n# Build the image\ndocker build -t dojo-mcp-server .\n\n# Run via stdio (for MCP hosts)\ndocker run -i --rm dojo-mcp-server\n\n# Run with skills path mounted\ndocker run -i --rm -v /path/to/CoworkPlugins:/skills -e DOJO_SKILLS_PATH=/skills dojo-mcp-server\n```\n\n## Project Structure\n\n```\nmcp-server/\n  cmd/server/main.go           Server entry point, env vars\n  internal/\n    dojo/\n      handler.go                7 MCP tool handlers\n      scaffolds.go              Scout and reflect methodology templates\n    skills/\n      loader.go                 Filesystem SKILL.md loader\n      search.go                 Keyword + trigger search\n      bundled.go                go:embed fallback (15 key skills)\n      bundled/                  Embedded SKILL.md files\n    decisions/\n      writer.go                 ADR file writer\n    wisdom/\n      base.go                   Wisdom base, search, helpers\n      seeds.go                  20 seed patches\n      resources.go              8 documentation resources\n  Dockerfile                    Multi-stage container build\n  .github/workflows/ci.yml     CI pipeline\n  .goreleaser.yml               Cross-platform release config\n```\n\n## Philosophy\n\nDojo Genesis is built on three core principles:\n\n1. **Beginner's Mind** -- Approach every interaction fresh, free from accumulated expertise.\n2. **Self-Definition** -- Help users see their own thinking, not impose external frameworks.\n3. **Understanding is Love** -- Deep, non-judgmental understanding is the highest service.\n\n## License\n\nMIT License -- see [LICENSE](LICENSE) for details.\n\nCopyright (c) 2026 Dojo Genesis\n\n## Contributing\n\nContributions are welcome. Please see [github.com/DojoGenesis](https://github.com/DojoGenesis) for organization-level guidelines.\n",
  "bytes": 11322,
  "sha": "2c605534054b99a743d87c72db687cfa967dac369528c7f153601055171dc346",
  "repo_slug": "dojogenesis/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dojogenesis_mcp_0224454d/readme"
}