Sekkei MCP Server

AI-powered generation of Japanese software specification documents following the V-model hierarchy. Works as an MCP server with Claude Code, Cursor, and VS Code/Copilot.

What It Does

Sekkei generates structured Japanese specification documents (設計書) from RFP/requirements using a V-Model Document Chain — each document's output feeds downstream documents:

                         RFP
                          │
                    ┌─────┴─────┐
                    ▼           ▼
              要件定義書       用語集
              Requirements    Glossary
                    │
              ┌─────┼──────────┐
              ▼     ▼          ▼
         機能一覧  NFR        プロジェクト計画書
         Function  Non-Func   Project Plan
         List      Req
              │
              ▼
         方式設計書 ────────────────────────────────────┐
         Architecture Design                          │
              │                                       │
              ▼                                       ▼
         基本設計書 ──────────────────► 受入テスト仕様書
         Basic Design                  UAT Spec
              │
        ┌─────┼──────────┬───────┐
        ▼     ▼          ▼       ▼
  セキュリティ  詳細設計書  DB設計  帳票/バッチ
  Security     Detail     DB     Report/Batch
  Design       Design     Design Design
                  │
             ┌────┼────┐
             ▼    ▼    ▼
          UT仕様書 IT仕様書 ST仕様書 ──► テスト結果報告書
          UT Spec  IT Spec  ST Spec     Test Result Report

Additional types: プロジェクト計画書, テスト計画書, 運用設計書, 移行設計書, CRUD図, トレーサビリティ, サイトマップ, 画面設計書, IF仕様書, テストエビデンス, 議事録, ADR.

Packages

Quick Start

Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/bienhoang/sekkei-ai-agents/main/setup.sh | bash

This installs everything: MCP server, Claude Code skill, CLI, Python export (Excel/PDF/DOCX), and runs sekkei doctor to verify.

Prerequisites: Node.js 20+, git, Python 3.9+, Claude Code.

Post-Install

sekkei doctor    # Check installation health
sekkei init      # Initialize project config (interactive wizard)

Generate Documents

/sekkei:requirements @rfp.md              # Generate requirements (first after RFP)
/sekkei:functions-list @requirements.md   # Generate function list
/sekkei:nfr @requirements.md              # Generate non-functional requirements
/sekkei:basic-design @requirements.md     # Generate basic design
/sekkei:detail-design @basic-design.md    # Generate detail design
/sekkei:ut-spec @detail-design.md         # Generate unit test spec
/sekkei:it-spec @basic-design.md          # Generate integration test spec

Preview

sekkei-preview          # Live preview in browser
sekkei-preview --edit   # WYSIWYG editing mode

Update

# Re-run the installer to update
curl -fsSL https://raw.githubusercontent.com/bienhoang/sekkei-ai-agents/main/setup.sh | bash

Alternative Install (Local Dev)

git clone git@github.com:bienhoang/sekkei-ai-agents.git && cd sekkei-ai-agents
chmod +x install.sh && ./install.sh          # Build + install (includes Python)
./install.sh --skip-python                   # Skip Python export setup

Windows Install

Sekkei runs natively on Windows (cmd.exe, PowerShell). No WSL2 required.

git clone https://github.com/bienhoang/sekkei-ai-agents.git
cd sekkei-ai-agents\packages\mcp-server
node bin/install.js                          # Full install (includes Python)
node bin/install.js --skip-python            # Skip Python export setup

Notes:

• Default export engine is Node.js (Playwright PDF + ExcelJS) — works out of the box
• Python venv auto-detected at .venv\Scripts\python.exe
• Symlinks require Developer Mode; without it, file copies are used as fallback
• Run npx sekkei doctor for platform-specific health diagnostics

Architecture

┌─────────────────┐     MCP (STDIO)     ┌──────────────────┐
│  @bienhoang/     │ ──────────────────→ │ @bienhoang/        │
│  sekkei-skills   │  /sekkei:* commands │  sekkei-mcp-server │
└─────────────────┘                      └────────┬─────────┘
                                                  │ generates
                                                  ↓
                                         ┌──────────────────┐
                                         │  Markdown Docs    │
                                         │  (workspace-docs/)   │
                                         └────────┬─────────┘
                                                  │ previews
                                                  ↓
                                         ┌──────────────────┐
                                         │  @bienhoang/      │
                                         │  sekkei-preview   │
                                         └──────────────────┘

MCP Server

• Transport: STDIO (stdout reserved for JSON-RPC, logs to stderr)
• 16 MCP Tools: generate_document, get_template, validate_document, get_chain_status, export_document, translate_document, manage_glossary, analyze_update, validate_chain, simulate_change_impact, import_document, manage_rfp_workspace, manage_change_request, update_chain_status, manage_plan, manage_version
• MCP Resources: templates:// for doc templates, rfp:// for RFP workflow instructions
• 27 Templates: Japanese (ja) with YAML frontmatter, 検印欄 (review stamps) — override with SEKKEI_TEMPLATE_OVERRIDE_DIR
• Python Bridge: execFile-based (no shell injection) for Excel/PDF/DOCX export via SEKKEI_INPUT env var

Dashboard (NEW)

Real-time analytics dashboard for specification chain monitoring:

• 5 pages: Overview, Chain Status, Analytics, Changes, Features
• Quality Metrics: Traceability coverage, health scoring, risk assessment (5-dimension weighted)
• Visualization: Traceability DAG (Recharts + @xyflow/react + dagre), risk/health radars, completion donuts
• Integration: MCP client integration, cached-mcp-service, workspace-scanner
• Client: React SPA with Tailwind CSS, Lucide icons
• Server: Express backend with 7 routes
• CLI: sekkei-dashboard command

CLI (sekkei command)

Built with citty. Available commands:

Slash Commands (Claude Code)

45 sub-commands covering the full V-model workflow:

Requirements Phase

Design Phase

Test Phase

Management

Supplementary & Utilities

Platform Setup

Claude Code

The recommended install method handles everything automatically:

curl -fsSL https://raw.githubusercontent.com/bienhoang/sekkei-ai-agents/main/setup.sh | bash

This installs the skill to ~/.claude/skills/sekkei/, registers the MCP server in ~/.claude/settings.json, and creates all /sekkei:* slash commands.

Cursor

npx sekkei-setup   # Auto-detect and configure
# Or manually:
mkdir -p .cursor/mcp && cp adapters/cursor/mcp.json .cursor/mcp/mcp.json

VS Code / Copilot

npx sekkei-setup
# Or manually:
mkdir -p .github && cp adapters/copilot/copilot-instructions.md .github/

Template Customization

Override default templates with company-specific versions:

export SEKKEI_TEMPLATE_OVERRIDE_DIR=./company-templates

Resolution order: override dir → default templates. Templates use Markdown with YAML frontmatter.

Build & Test

# From sekkei/ root (monorepo)
npm run build           # Build all packages
npm test                # Run tests (mcp-server)

# From packages/mcp-server/
npm run build           # tsc compile
npm run lint            # tsc --noEmit (type check)
npm test                # Jest with ESM
npm run test:unit       # Unit tests only

Project Structure

sekkei/
├── package.json                 # Root: npm workspaces
├── tsconfig.base.json           # Shared TypeScript config
├── install.sh                   # Local install script for Claude Code
├── sekkei.config.example.yaml   # Template for project config
├── packages/
│   ├── mcp-server/              # @bienhoang/sekkei-mcp-server (v2.8.0)
│   │   ├── src/
│   │   │   ├── tools/           # 15 MCP tool handlers
│   │   │   ├── resources/       # Template + RFP instruction resources
│   │   │   ├── lib/             # 57+ core logic modules (quality metrics, analyzers, etc.)
│   │   │   └── cli/             # CLI commands (citty-based)
│   │   ├── templates/ja/        # 27 Japanese doc templates (IPA V-Model compliant)
│   │   ├── python/              # Export layer (Excel, PDF, DOCX, glossary, diff)
│   │   ├── bin/                 # setup.js, init.js, cli.js
│   │   └── adapters/            # Platform configs (Claude Code, Cursor, Copilot)
│   ├── preview/                 # @bienhoang/sekkei-preview (v1.3.4)
│   │   └── src/
│   │       ├── client/          # React + Tiptap v3 WYSIWYG editor
│   │       └── server/          # Express server + API
│   ├── dashboard/               # @bienhoang/sekkei-dashboard (v0.1.1)
│   │   ├── src/
│   │   │   ├── pages/           # 5 dashboard pages (React)
│   │   │   ├── components/      # Charts (Recharts), traceability graph
│   │   │   ├── services/        # MCP client, snapshot, workspace scanner
│   │   │   └── server/          # Express backend (7 routes)
│   │   └── cli.ts               # CLI command entry
│   └── skills/                  # @bienhoang/sekkei-skills (v1.5.4)
│       ├── bin/install.js       # Skill installer
│       └── content/SKILL.md     # 44 sub-commands + workflow router
└── .github/                     # CI/CD

Requirements

• Node.js >= 20.0.0
• Python 3 (optional) — only for Excel/PDF/DOCX export
  • Dependencies: openpyxl, weasyprint, mistune, pyyaml

FAQ

Q: Do I need Python? A: Only for Excel/PDF/DOCX export. Core document generation and validation work without Python.

Q: Can I customize templates? A: Yes. Set SEKKEI_TEMPLATE_OVERRIDE_DIR to your custom templates directory.

Q: What languages are supported? A: Templates are in Japanese (ja). Use /sekkei:translate to translate to any language.

Q: Does it work with Cursor/Copilot? A: Yes. Run npx sekkei-setup or manually copy adapter files.

Q: How do I update? A: Re-run the setup script: curl -fsSL https://raw.githubusercontent.com/bienhoang/sekkei-ai-agents/main/setup.sh | bash

Q: How do I check if everything is working? A: Run sekkei doctor — it checks all components and suggests fixes for any issues.

License

MIT