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等を推奨

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

Related MCP server: @forgespace/ui-mcp

🚀 セットアップ

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（常にアクセス可能）：

🛠️ 提供されるツール

v2.0のツール

v2.1で追加予定

🎯 実際の体験

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次元スコア）

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

🛣️ ロードマップ

v2.0（現在）✅

• 4次元の原則をResource化

• シンプルさの原則

• Figma的UI推奨（必須要件）

• Resource/Prompt機能

• 既存ツールの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 - 水面下で素晴らしいアプリケーションを生み出します

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