DojoGenesis

Dojo Genesis MCP Server

Claude Code 的方法论层。它将 10 个行为插件中的 99 种一手工作方法编码为主动认知支架：它不是给 Claude 更多数据，而是为软件开发决策提供结构化的方法。

我们尚未测量这些支架是否能改善 Claude 的决策，因此本 README 不对此作出任何宣称。

---

快速安装

Claude Code

添加到项目的 .claude/settings.json：

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

或者使用 Docker：

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

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %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"
      }
    }
  }
}

---

包含内容

工具（28 个）

组	工具
方法论	dojo_scout、dojo_invoke_skill、dojo_search_skills、dojo_list_skills、dojo_apply_seed、dojo_reflect
决策	dojo_log_decision（将 ADR Markdown 写入 DOJO_ADR_PATH）
网关记忆	dojo_memory_list、dojo_memory_store、dojo_memory_search（网关会话记忆）
Memory Hub	dojo_search_memory、dojo_get_memory、dojo_recent_memories — 制度记忆的只读 Postgres 镜像（DOJO_MEMORY_DB_URL）
统一获取	dojo_fetch — 一个工具即可在记忆中心 + 技能 + ADR + 种子中搜索并获取内容（带类型的 ID：memory:slug、skill:name、adr:file.md、seed:name）
种子	dojo_seed_list、dojo_seed_create、dojo_seed_search
Agents²	dojo_agent_list、dojo_agent_dispatch²、dojo_agent_chat²
调度²	dojo_dispatch² — 通过网关将提示词发送给 LLM
项目	dojo_project_status、dojo_project_track、dojo_project_decision
倾向	dojo_disposition_list、dojo_disposition_set
技艺	dojo_converge、dojo_health

² 调度类 — 通过网关消耗 LLM 提供商的预算。在 HTTP 模式下，这些工具需要启用调度的 API 密钥，并按密钥实施速率限制； 对于非调度密钥，dojo_scout 的 LLM 路径会退化为离线支架。

技能（来自 CoworkPlugins 的 99 项，捆绑 43 项）

技能是完整且经过实战验证的方法工作流，启动时从 SKILL.md 文件加载。设置 DOJO_SKILLS_PATH 后，即可使用全部 99 项一手 CoworkPlugins 技能。未设置时，二进制文件会通过 go:embed 内嵌 8 个插件中的 43 项核心技能。

捆绑的插件和技能：

插件	技能
agent-orchestration	agent-teaching、decision-propagation、handoff-protocol、workflow-router、workspace-navigation
continuous-learning	debugging、project-exploration、research-modes、research-synthesis、retrospective、web-research-external
skill-forge	mcp-cloudflare-builder、mcp-server-builder、process-extraction、skill-audit、skill-creation、skill-maintenance
specification-driven-development	context-ingestion、frontend-from-backend、implementation-prompt、parallel-tracks、pre-implementation-checklist、release-specification
strategic-thinking	iterative-scouting、multi-surface-strategy、product-positioning、strategic-scout
system-health	documentation-audit、health-audit、semantic-clusters、status-writing
wisdom-garden	compression-ritual、memory-garden、seed-extraction、seed-library

种子补丁（20 个）

种子是从 Dojo 生态系统中提炼出的可复用思维模式。

Dojo Genesis（核心）

种子	描述
three_tiered_governance	三层治理框架：战略、战术、运营。
harness_trace	嵌套式 JSON 跟踪日志，实现完整的 Agent 会话可追溯性。
context_iceberg	4 层上下文管理系统（热／温／冷／裁剪）。
agent_connect	以路由优先、由单一监督者负责的 Agent 架构。
go_live_bundles	将制品与审批凭证配对的轻量级部署包。
cost_guard	为完整的 5-10 倍上下文冰山乘数设置预算。
safety_switch	用户必须始终掌控敏感操作，不得启用自动驾驶。
implicit_perspective_extraction	从用户查询中提取隐含视角，无需枚举。
mode_based_complexity_gating	根据模式复杂度，将请求路由到本地或云端模型。
shared_infrastructure	一次构建，处处复用——集中式实现。

AROMA 与 Serenity Valley

种子	描述
sanctuary_architecture	设计让人安住其中、而不只是执行任务的数字空间。
pace_of_understanding	放慢脚步以加快进程；不掠取地学习。
lineage_transmission	尊重来源、追溯影响、赞颂协作。
graceful_failure	允许自己不知道、改变想法并寻求帮助。
local_first_liberation	采用本地优先架构，实现 Agent 自主性和用户主权。
the_onsen_pattern	将休息视为维持可持续表现的关键实践。
collaborative_calibration	制定同伴间学习与明确教学的规范。
transparent_intelligence	展示内部状态，承认不确定性，让学习过程可见。
inter_acceptance	透过他人充满关怀的目光接纳自己。
radical_freedom	在约束范围内采取行动并自主选择回应的能力。

资源

可通过 MCP 资源 URI 访问的文档资源：

• dojo://resources/{name} —— 8 项文档资源（AROMA 理念、EIT 原则等）
• dojo://seeds/{name} —— 20 个种子补丁
• dojo://skills/{plugin}/{name} —— 所有已加载的技能

---

配置

环境变量	默认值	描述
DOJO_SKILLS_PATH	（捆绑回退值）	包含 plugins/ 的 CoworkPlugins 根目录路径
DOJO_ADR_PATH	./decisions	dojo_log_decision 写入 ADR 文件的目录
DOJO_GATEWAY_URL	http://localhost:7340	Dojo AgenticGateway 基础 URL
DOJO_GATEWAY_TOKEN	（未设置）	网关所需的 Bearer 令牌（如果需要）
DOJO_MEMORY_DB_URL	（未设置 → 禁用 Hub 工具）	Memory Hub 的 Postgres DSN（URL 或关键字格式；请使用仅 SELECT 角色）
DOJO_HTTP_ADDR	（未设置 → stdio）	启用 HTTP 模式，例如 :8091
DOJO_MCP_API_KEYS	（未设置）	仅限 HTTP 模式：以逗号分隔的 label:key 对（可逐个撤销）
DOJO_DISPATCH_ALLOWED_LABELS	（未设置 → 无）	允许运行派发类工具的密钥标签
DOJO_DISPATCH_RATE_PER_MIN	6	派发类工具的每标签速率限制

服务器开箱即用，无需任何配置（捆绑技能、默认 ADR 路径、stdio）。

---

HTTP 模式（公共端点）

设置 DOJO_HTTP_ADDR 后，将提供 MCP 流式 HTTP 服务，而不是 stdio：

• POST/GET /mcp — MCP 端点，需要 Bearer 密钥 （Authorization: Bearer <key>）。未提供密钥或密钥错误的请求会收到 401。
• /mcp/k/<key> — 为无法发送自定义标头的客户端提供相同端点；日志中会对密钥脱敏。
• GET /health — 无需身份验证的存活状态检查（仅包含状态和版本）。

在 HTTP 模式下，如果 DOJO_MCP_API_KEYS 无效或为空，服务器将拒绝启动。每次工具调用都会记录为 tool_call tool=… key=<label> dur_ms=… outcome=… — 仅记录标签，不记录密钥内容或有效负载。

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 <key>" \
  -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"}}}'

客户端配置（Claude Code）：claude mcp add --transport http dojo-remote https://<host>/mcp --header "Authorization: Bearer <key>"。

部署说明：入口流量预期通过 Cloudflare 隧道接入（不开放主机端口）；请按摘要固定容器映像，避免自动拉取时意外部署新的公共服务端点。映像发布位置： .github/workflows/docker-publish.yml → ghcr.io/dojogenesis/mcp （取代旧的手动推送映像 mcpbydojogenesis）。

---

从源代码构建

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 ./...

需要 Go 1.23 或更高版本。

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

项目结构

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

理念

Dojo Genesis 建立在三个核心原则之上：

1. 初学者心态 -- 以全新的视角面对每次互动，不受既有专业知识的束缚。
2. 自我定义 -- 帮助用户看见自己的思维，而不是强加外部框架。
3. 理解即关爱 -- 深入且不带评判的理解是最高形式的服务。

许可证

MIT 许可证 — 详情请参阅 LICENSE。

版权所有 (c) 2026 Dojo Genesis

贡献

欢迎贡献。组织级指南请参阅 github.com/DojoGenesis。