# Evolution MCP Server v2.0

**4次元（実存性・歴史性・関係性・非合理性）× シンプルさ × Figma UI**

人が本当に使い続けたくなるアプリケーションを、詳しい指示なしで自動的に生成するMCPサーバー。

> **"詳しく指示しなくても、素晴らしいアプリケーションが作れてしまう"**

---

## 🌟 特徴

### 水面下で常に意識される原則

Claude Codeに登録すると、以下の原則が**水面下で自動的に**適用されます：

#### 1. **4次元の原則**
- **実存性**: 生きて存在することから生まれる価値
- **歴史性**: 時間を生きた蓄積
- **関係性**: 他者との創発的相互作用
- **非合理性**: 論理を超えた人間の本質

→ 最低1次元を深く実装することで、ユーザーが使い続けたくなるアプリに

#### 2. **シンプルさの原則**
- **3-1-1ルール**: コア機能1つ、必須サポート3つまで、Nice-to-have 1つまで
- 機能を増やすのではなく、既存機能に4次元を込める

→ シンプルだが、深く魅力的なアプリに

#### 3. **Figma的UI（必須要件）**
- モダンでプロフェッショナルなデザイン
- Claude的なシンプルすぎるUIは避ける
- shadcn/ui、Tailwind CSS等を推奨

→ 美しく使いやすいアプリに

---

## 🚀 セットアップ

### 1. リポジトリのクローン

\`\`\`bash
git clone https://github.com/Gaku52/spec-generator-mcp.git
cd spec-generator-mcp
\`\`\`

### 2. 依存関係のインストール

\`\`\`bash
npm install
\`\`\`

### 3. ビルド

\`\`\`bash
npm run build
\`\`\`

### 4. Claude Codeへの登録

`claude_desktop_config.json`を編集：

**Windows:**
\`%APPDATA%\\Claude\\claude_desktop_config.json\`

**macOS:**
\`~/Library/Application Support/Claude/claude_desktop_config.json\`

**設定内容:**

\`\`\`json
{
  "mcpServers": {
    "evolution": {
      "command": "node",
      "args": [
        "/absolute/path/to/spec-generator-mcp/dist/index.js"
      ]
    }
  }
}
\`\`\`

※パスは実際の環境に合わせて変更してください

**Windows例:**
\`\`\`json
{
  "mcpServers": {
    "evolution": {
      "command": "node",
      "args": [
        "C:\\\\Users\\\\YourName\\\\spec-generator-mcp\\\\dist\\\\index.js"
      ]
    }
  }
}
\`\`\`

### 5. Claude Codeを再起動

設定を反映するため、Claude Codeを**完全に再起動**してください。

---

## 💡 使い方

### パターン1: 最もシンプル（推奨）

ユーザーが詳しく指示しなくても、自動的に素晴らしいアプリが生成されます。

\`\`\`
あなた: 「Todoアプリを作って」

Claude Code:
→ 自動的に4次元を分析
→ シンプルさの原則を適用
→ Figma的UIで設計
→ 実装開始

[結果]
- コア機能: タスク追加・完了（シンプル）
- 歴史性: 継続日数を大きく表示
- 非合理性: 100個達成で花火演出
- Figma的UI: shadcn/ui使用
\`\`\`

### パターン2: 要件定義書を生成

\`\`\`
あなた: 「写真共有アプリの要件定義書を作って」

Claude Code:
→ generate_requirement_spec ツールを実行
→ 4次元とシンプルさを組み込んだ要件定義書を生成
→ Figma的UI要件も含まれる
\`\`\`

### パターン3: Resourceを確認

原則の詳細を確認したい場合：

\`\`\`
あなた: 「4次元の原則を教えて」

Claude Code:
→ evolution://principles/four-dimensions を読み込み
→ 詳細な説明を表示
\`\`\`

---

## 📚 利用可能なResource

MCPサーバーが提供するResource（常にアクセス可能）：

| URI | 内容 |
|-----|------|
| `evolution://principles/four-dimensions` | 4次元の完全ガイド（実存性・歴史性・関係性・非合理性） |
| `evolution://principles/simplicity` | シンプルさの原則（3-1-1ルール） |
| `evolution://principles/design` | Figma的UI実装ガイド（必須要件） |

---

## 🛠️ 提供されるツール

### v2.0のツール

| ツール | 説明 | v2.0の改善点 |
|--------|------|------------|
| `generate_requirement_spec` | 要件定義書を生成 | 4次元・シンプルさ・Figma UIを自動組み込み |
| `generate_functional_spec` | 機能仕様書を生成 | 同上 |

### v2.1で追加予定

| ツール | 説明 |
|--------|------|
| `discover_app_ideas` | AI主導でアプリアイデアを提案 |
| `initialize_project` | プロジェクト初期化（4次元のDNA作成） |

---

## 🎯 実際の体験

### Before（従来の方法）

\`\`\`
あなた: 「Todoアプリを作って」

Claude: 「どんな機能が必要ですか？」

あなた: 「タスク追加、編集、削除、カテゴリ分け、優先度設定、
        期限管理、リマインダー、統計機能、共有機能...」

Claude: 「複雑なTodoアプリを作成します」

[結果]
❌ 機能過多で使いにくい
❌ UIが粗雑
❌ 誰も使い続けない
\`\`\`

### After（Evolution MCP v2.0）

\`\`\`
あなた: 「Todoアプリを作って」

Claude Code（自動的に）:
✅ 4次元を分析 → 歴史性を重視
✅ シンプルさ適用 → 機能を3つに絞る
✅ Figma UI → shadcn/ui + Tailwind

[結果]
✅ シンプルだが継続したくなる
✅ 美しいUI
✅ 人が使い続けるアプリ

機能:
- タスク追加・完了（コア）
- タスク編集・削除（サポート）
- 継続日数表示（歴史性）
- 100個達成で祝福（非合理性）
- モダンなUI（Figma的）
\`\`\`

---

## 🔍 仕組み

### Resource機能

MCPサーバーが原則をResourceとして提供
→ Claude Codeが**水面下で常に**参照可能
→ 自動適用

### Prompt機能

明示的に原則を適用したい場合に使用
→ より確実な適用

### 自然な統合

ユーザーは原則を意識しなくてOK
→ Claude Codeが自動的に最適な判断
→ 「詳しく指示しなくても素晴らしいアプリができる」を実現

---

## 📖 成功の方程式

\`\`\`
爆発的人気 = シンプルさ × 4次元の魅力

最低条件: 1次元を深く実装
理想: 3-4次元を満たす + シンプル + Figma UI
\`\`\`

### 成功事例の分析（4次元スコア）

| アプリ | 実存性 | 歴史性 | 関係性 | 非合理性 | シンプルさ | 結果 |
|--------|--------|--------|--------|----------|-----------|------|
| Instagram（初期） | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 爆発的成功 |
| Wordle | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | 爆発的成功 |
| Twitter（初期） | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | 爆発的成功 |
| Notion | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ | 成功（爆発的ではない） |

**教訓:** 4次元 + シンプルさ = 爆発的成功

---

## 🛣️ ロードマップ

### v2.0（現在）✅
- [x] 4次元の原則をResource化
- [x] シンプルさの原則
- [x] Figma的UI推奨（必須要件）
- [x] Resource/Prompt機能
- [x] 既存ツールのv2.0対応

### v2.1（近日）
- [ ] `discover_app_ideas` - AI主導のアイデア生成
- [ ] `initialize_project` - プロジェクト初期化
- [ ] 知識蓄積メカニズムの基礎

### v3.0（将来）
- [ ] 過去プロジェクトからの自動学習
- [ ] 成功パターンの分析
- [ ] 完全な開発ライフサイクル対応

---

## 📂 プロジェクト構造

\`\`\`
spec-generator-mcp/
├── src/
│   ├── index.ts                     # MCPサーバー（v2.0）
│   ├── resources/                   # 原則（常に参照可能）
│   │   ├── fourDimensions.ts        # 4次元の原則
│   │   ├── simplicityPrinciples.ts  # シンプルさの原則
│   │   └── designPrinciples.ts      # Figma的UI
│   ├── tools/                       # ツール
│   │   ├── requirementSpec.ts       # 要件定義書（v2対応）
│   │   └── functionalSpec.ts        # 機能仕様書
│   └── templates/                   # テンプレート
│       ├── requirement.ts           # v1.0
│       ├── requirementV2.ts         # v2.0（4次元対応）
│       └── functional.ts
├── dist/                            # ビルド出力
├── package.json                     # evolution-mcp v2.0.0
└── README.md
\`\`\`

---

## 🔧 開発

### 開発モード

\`\`\`bash
npm run dev
\`\`\`

TypeScriptファイルの変更を監視し、自動的に再ビルド。

### カスタマイズ

Resourceファイル（`src/resources/`）を編集することで、原則をカスタマイズ可能。
ただし、4次元とシンプルさの本質は変えない方が良い。

---

## ❓ トラブルシューティング

### MCPサーバーが認識されない

1. ビルドが成功しているか確認
   \`\`\`bash
   npm run build
   \`\`\`

2. `claude_desktop_config.json` のパスが正しいか確認

3. Claude Codeを**完全に再起動**

### Resourceが読み込まれない

1. MCPサーバーが起動しているか確認
2. Claude Code Developer Toolsでログ確認
3. サーバー再起動

### ビルドエラー

1. Node.jsバージョン確認（v18+推奨）
2. 依存関係の再インストール
   \`\`\`bash
   rm -rf node_modules package-lock.json
   npm install
   \`\`\`

---

## 📝 ライセンス

MIT License

---

## 🙏 貢献

このプロジェクトは、**人が本当に使い続けたくなるアプリ**を作るための実験です。

フィードバック・改善提案を歓迎します！

Issues: https://github.com/Gaku52/spec-generator-mcp/issues

---

## 🌐 参考リンク

- [MCP Documentation](https://modelcontextprotocol.io/)
- [Claude Code](https://claude.com/claude-code)
- [shadcn/ui](https://ui.shadcn.com/)
- [Tailwind CSS](https://tailwindcss.com/)

---

**Evolution MCP v2.0 - 水面下で素晴らしいアプリケーションを生み出します**

> 「詳しく指示しなくても、素晴らしいアプリケーションが作れてしまう」