DojoGenesis MCP

Dojo Genesis MCP Server

The methodology layer for Claude Code. It encodes 99 first-party working methods across 10 behavioral plugins as active cognitive scaffolds: instead of giving Claude more data, it gives Claude structured *methods* for software development decisions.

We have not yet measured whether these scaffolds improve Claude's decisions, so this README makes no claim that they do.

Quick Install

Claude Code

Add to your project's .claude/settings.json:

{

"mcpServers": { "dojo": { "command": "/path/to/dojo-mcp-server", "env": { "DOJO_SKILLS_PATH": "/path/to/CoworkPluginsByDojoGenesis", "DOJO_ADR_PATH": "./decisions" } } } }

Or using Docker:

{

"mcpServers": { "dojo": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/dojogenesis/mcp-server:latest"] } } }

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

"mcpServers": { "dojo": { "command": "/path/to/dojo-mcp-server", "env": { "DOJO_SKILLS_PATH": "/path/to/CoworkPluginsByDojoGenesis", "DOJO_ADR_PATH": "./decisions" } } } }

What's Included

Tools (28)

² Dispatch-class — spends LLM provider budget through the gateway. In HTTP mode these require a dispatch-enabled API key and are rate limited per key; dojo_scout's LLM path degrades to its offline scaffold for non-dispatch keys.

Skills (99 from CoworkPlugins, 43 bundled)

Skills 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, 43 key skills across 8 plugins are embedded in the binary via go:embed.

Bundled plugins and skills:

Seed Patches (20)

Seeds are reusable thinking patterns drawn from across the Dojo ecosystem.

Dojo Genesis (Core)

AROMA & Serenity Valley

Resources

Documentation resources accessible via MCP resource URIs:

• dojo://resources/{name} -- 8 documentation resources (AROMA philosophy, EIT principles, etc.)
• dojo://seeds/{name} -- 20 seed patches
• dojo://skills/{plugin}/{name} -- All loaded skills

Configuration

The server works out of the box with zero configuration (bundled skills, default ADR path, stdio).

HTTP Mode (public endpoint)

Setting DOJO_HTTP_ADDR serves MCP streamable-HTTP instead of stdio:

• POST/GET /mcp — the MCP endpoint, Bearer-key required (Authorization: Bearer ). Keyless or wrong-key requests get 401.
• /mcp/k/ — same endpoint for clients that cannot send custom headers; the key is redacted in logs.
• GET /health — unauthenticated liveness (status + version only).

The server refuses to start in HTTP mode without a valid, non-empty DOJO_MCP_API_KEYS. Every tool call is logged as tool_call tool=… key= dur_ms=… outcome=… — labels only, never key material, never payloads.

DOJO_HTTP_ADDR=:8091 \

DOJO_MCP_API_KEYS="win:$(openssl rand -hex 32)" \ ./dojo-mcp-server

curl -s localhost:8091/health curl -s -X POST localhost:8091/mcp \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Client wiring (Claude Code): claude mcp add --transport http dojo-remote https:// /mcp --header "Authorization: Bearer ".

Deployment notes: ingress is expected to be a Cloudflare tunnel (no host ports); pin the container image by digest so auto-pull never surprise-deploys a new public surface. Image publishing: .github/workflows/docker-publish.yml → ghcr.io/dojogenesis/mcp (supersedes the old manually-pushed mcpbydojogenesis image).

Building from Source

git clone https://github.com/DojoGenesis/mcp.git

cd mcp

Build

go build -o dojo-mcp-server ./cmd/server

Run

./dojo-mcp-server

Test

go test -race -v ./...

Requires Go 1.23 or later.

Docker

# Build the image

docker build -t dojo-mcp-server .

Run via stdio (for MCP hosts)

docker run -i --rm dojo-mcp-server

Run with skills path mounted

docker run -i --rm -v /path/to/CoworkPlugins:/skills -e DOJO_SKILLS_PATH=/skills dojo-mcp-server

Project Structure

mcp-server/

cmd/server/main.go Server entry point, env vars internal/ dojo/ handler.go 7 MCP tool handlers scaffolds.go Scout and reflect methodology templates skills/ loader.go Filesystem SKILL.md loader search.go Keyword + trigger search bundled.go go:embed fallback (15 key skills) bundled/ Embedded SKILL.md files decisions/ writer.go ADR file writer wisdom/ base.go Wisdom base, search, helpers seeds.go 20 seed patches resources.go 8 documentation resources Dockerfile Multi-stage container build .github/workflows/ci.yml CI pipeline .goreleaser.yml Cross-platform release config

Philosophy

Dojo Genesis is built on three core principles:

1. Beginner's Mind -- Approach every interaction fresh, free from accumulated expertise.
2. Self-Definition -- Help users see their own thinking, not impose external frameworks.
3. Understanding is Love -- Deep, non-judgmental understanding is the highest service.

License

MIT License -- see LICENSE for details.

Copyright (c) 2026 Dojo Genesis

Contributing

Contributions are welcome. Please see github.com/DojoGenesis for organization-level guidelines.