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サーバーが認識されない

ビルドが成功しているか確認

\\\bash npm run build \\\

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

Claude Codeを完全に再起動

Resourceが読み込まれない

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

ビルドエラー

Node.jsバージョン確認（v18+推奨）
依存関係の再インストール

\\\bash rm -rf node_modules package-lock.json npm install \\\

---

📝 ライセンス

MIT License

---

🙏 貢献

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

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

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

---

🌐 参考リンク

---

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

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

Evolution MCP Server