{"id":"884adc00-e9bf-4c2e-8ae9-25485cec1c50","slug":"daozhu","kind":"mcp","name":"daozhu","summary":"daozhu - Tao philosophy AI orchestrator","owner":"ddg94360-code","repoUrl":"https://github.com/ddg94360-code/daozhu","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-08-12T15:58:04.000Z","addedAt":"2026-10-21T04:57:04.603Z","logoUrl":"https://avatars.githubusercontent.com/u/243967099?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","cloud-infra"],"tags":["ai-agent","ai-orchestrator","chinese-philosophy","claude-code","eastern-philosophy","personal-assistant","taoism"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T04:10:03.313Z","sample":false,"url":"https://conduits.dev/tools/daozhu","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# 道樞 Dàoshū — An Eastern-Philosophy AI Orchestrator\n\n> **Languages:** [English](README.md) · [繁體中文](README.zh-TW.md)\n\n**道樞 (Dàoshū, \"Pivot of the Tao\")** is a self-adaptive AI agent framework grounded in Eastern philosophy. A seven-layer perception network runs in the background to answer three questions about every input — *who are you, how are you, what do you need* — then decides which philosophical school should respond.\n\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)\n[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](mcp)\n[![CI](https://github.com/ddg94360-code/daozhu/actions/workflows/test.yml/badge.svg)](https://github.com/ddg94360-code/daozhu/actions)\n\nFeeling low? It answers as Taoism (道家). Stuck with a person? Confucianism (儒家). Negotiating? Strategic School (縱橫家). Torn between options? It convenes a cabinet meeting. Every reply is prefixed with `【感知：XXX】` (perception tag).\n\n## Features\n\n- **Seven-layer perception network** — emotion, task, interpersonal, complexity, concise-mode, tone, energy — fully automatic in the background\n- **Cabinet of four schools** — Confucian (dual internal/external), Taoist (three-tier), Legalist (dual-domain / three-table), Strategist (opening-three-questions)\n- **Three advisory patches** — Military (embedded in Strategist), Mohist logic (in Legalist), Buddhist insight (in Taoist)\n- **Seven skill modules** — Work Guide, Virtual Masters, Music Companion, Metaphysical Mirror (hexagram/tarot/astrology/feng-shui/archetype/dream/oracle), Solar Terms, Cabinet Meeting, Skill Routing (hook in your own skills)\n- **Memory layer MCP** — 27 tools: expense, health, reminders, shopping, mood journal, study notes (incl. mark-reviewed), decision log, weekly report, energy insight, strategy vault (道藏), solar-term calendar, CSV export, config\n- **Local-first** — memory stored in `local_memory/` as JSON, atomic writes prevent corruption, nothing leaves your machine\n\n## Architecture\n\n```\nUser input\n    ▼\n┌─────────────────────────────────────┐\n│  Perception Network (7 layers)      │\n│  emotion → task → interpersonal     │\n│  → complexity → concise → tone      │\n│  → energy                           │\n└─────────────────────────────────────┘\n    ▼\n┌─────────────────────────────────────┐\n│  Dispatch layer                     │\n│  Cabinet (4 schools + 3 patches)    │\n│  + 7 skill modules + routing        │\n└─────────────────────────────────────┘\n    ▼\n┌─────────────────────────────────────┐\n│  Memory layer (daozhu-mcp · 27 tools)│\n└─────────────────────────────────────┘\n```\n\n## Installation (Claude Code)\n\n1. **Copy the skill and MCP server into your project:**\n   ```bash\n   cp -r skills/daozhu   <your-project>/.claude/skills/daozhu\n   cp -r mcp             <your-project>/.claude/daozhu-mcp\n   ```\n\n2. **Install Python dependencies** (for the memory layer):\n   ```bash\n   pip install -r .claude/daozhu-mcp/requirements.txt\n   ```\n\n3. **Configure MCP:** copy `.mcp.json.example` to `.mcp.json` at your project root and edit paths.\n\n4. **Trust the project MCP servers** — add to `.claude/settings.local.json`:\n   ```json\n   { \"enableAllProjectMcpServers\": true }\n   ```\n   > ⚠️ Note for VSCode extension environments: Claude Code reads the repo-root `.mcp.json`, **not** `.claude/mcp.json`.\n\n5. **Optional:** reference it in your `CLAUDE.md`:\n   ```markdown\n   All conversations are dispatched by the `daozhu` skill — see `.claude/skills/daozhu/SKILL.md`.\n   ```\n\n6. **Reload Window**, run `/mcp`, confirm `daozhu` shows **Connected**.\n\n## Quick Start\n\n| You say | 道樞 does |\n|---------|-----------|\n| \"I'm so frustrated / exhausted\" | Taoism + Buddhist patch, `【感知：情緒低落】` |\n| \"How do I deal with my professor/teammate\" | Confucian external + Strategist |\n| \"Should I take this project?\" (complex) | Cabinet meeting (5 stages) |\n| \"Help me plan my study schedule\" | Work Guide (4 phases) |\n| \"Lunch cost 150\" | Expense log + auto-categorize |\n| \"I'm feeling down today\" | Mood journal + classification + streak detection |\n| \"How was my week?\" | Weekly report + energy insight |\n| \"System status\" | Memory-store health check |\n\n## Command Reference\n\n| Command | Function |\n|---------|----------|\n| `/儒家` / `/道家` / `/法家` / `/縱橫家` | Switch school manually |\n| `/會議 [question]` | Force a cabinet meeting |\n| `/工 [task]` / `/工 急` / `/工 深` / `/工 程式` | Work Guide |\n| `/費曼` `/蘇格拉底` `/張愛玲` … | Summon a virtual master |\n| `/[musician]` / `/播 [mood]` | Music companion |\n| `/卦` `/塔羅` `/星盤` `/風水` `/星` `/夢` `/緣` | Metaphysical mirror (7 modes) |\n| `/節氣` | Solar-term wellness reminder |\n| `/兵` `/辯` `/觀` | Force Military/Mohist/Buddhist patch |\n| `/外治` `/內修` `/域` | Legalist domain switch |\n| `/藏` | Save a strategy to the vault |\n| `/快` / `/慢` | Toggle concise mode |\n\n## Routing to Your Own Skills\n\nWhen the perception network detects an explicit **creation/development** request, it routes to your project's existing skills (writing, game dev, web, debugging…) per `skills/daozhu/workflows/routing-workflow.md`. Routed skills become 道樞's own modules — handed off with perception context, their internal flow untouched. If no matching skill exists, the cabinet responds instead.\n\n## Memory Layout (`local_memory/`)\n\n```\nlocal_memory/\n├── daily/          # expenses, health, reminders, shopping, moods, notes, decisions\n└── daozang/        # per-school strategy vault\n```\n\n## Configuration (`config.yaml`, optional)\n\nCopy `mcp/config.yaml.example` to `mcp/config.yaml` to override:\n- `timezone` — display timezone\n- `currency` — expense currency symbol (`TWD`/`HKD`/`USD`/`JPY`/`CNY`/`EUR`/`GBP`/`KRW`)\n- `review_weekday` / `review_time` — weekly-report schedule\n- `energy_analysis_days` — days needed before energy analysis is produced\n- `high_speed_threshold` — concise-mode trigger threshold (words/min, used by the dispatch layer)\n\n`yaml` is an optional dependency — without it, defaults are used silently.\n\n## Local dashboard (optional)\n\nA loopback-only web UI for the same `local_memory/` the MCP uses. Not a chat window.\n\n```bash\npip install -r mcp/requirements-web.txt\n# optional: point at an existing store (e.g. a Claude Code project copy)\n# Windows:\nset DAOZHU_MEMORY_DIR=C:\\path\\to\\local_memory\n# POSIX:\nexport DAOZHU_MEMORY_DIR=/path/to/local_memory\npython -m web\n```\n\nOpen `http://127.0.0.1:8765`. Three pages: board `/`, cabinet `/cabinet`, mirror `/xinjing`. Binds to `127.0.0.1` only. A left rail switches pages and themes (Daoist default / Confucian / Legalist / Strategist / Taiji) and remembers the choice in `localStorage`; below 720px the rail collapses to one-character icons. The board has a chat line that first matches rules (`午餐吃了 150`); optional `DAOZHU_LLM_API_KEY` classifies leftovers. Cabinet can convene a five-stage meeting (`brief` / `deep` / `flash`) and follow up one minister. The mirror still plays JSON; set `DAOZHU_TIANJI_DIR` to a local tianji-mcp checkout for real tarot / gua / fengshui / chart / bazi / ziwei / meihua. Optional thin desktop: `python -m web.desktop`. Optional native window (needs pywebview): `python -m web.desktop --window`. Optional VS Code sidebar lives in `extension/` (local vsix only, not Marketplace).\n\n## Development\n\n```bash\ncd mcp\npip install -r requirements.txt\npython -m pytest tests/          # 42 tests across 4 suites\npython server.py                 # run MCP server over stdio\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) and [CHANGELOG.md](CHANGELOG.md).\n\n## License\n\n[Apache License 2.0](LICENSE) — see [NOTICE](NOTICE) for the project authors.\n"}