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
• Claude Code
• shadcn/ui
• Tailwind CSS

---

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

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