Vibe Coder MCP Server

Vibe Coder MCP サーバー

Vibe Coder は、AI アシスタント（Cursor、Cline AI、Claude Desktop など）にソフトウェア開発向けの強力なツールを提供し、その能力を高めるために設計された MCP（Model Context Protocol）サーバーです。調査、計画、要件の生成、スタータープロジェクトの作成などを支援します！

🆕 バージョン 0.3.5 の新機能

🎉 最新リリース — 強化された CLI、REPL、パラメーター抽出

主な改善点：

• ✨ ハイブリッドマッチャーを全面刷新：15 個すべての MCP ツールに包括的なパラメーター抽出機能を追加
• 🚀 CLI／REPL の操作性：対話形式の確認、視覚的な進捗表示によるジョブステータスのポーリング
• 🔧 重大なバグを修正：Task-list-generator がユーザーストーリーを自動生成するようになり、複数ターンの会話も確実に動作
• 📊 ツールマッチングを改善：複数の戦略を採用（キーワード 35%、パターン 30%、セマンティック 15%、LLM 20%）
• ⚡ TypeScript の厳格モード：any 型ゼロ、すべて明示的な型指定を行い、本番環境に適したコード品質を実現

ユーザーエクスペリエンスの強化：

• マッチングの信頼度が低い場合、ユーザーに確認を求めるようになりました
• 実行時間の長いジョブで視覚的な進捗インジケーターを表示
• 対話モードで JSON ログをフィルタリングし、出力を簡潔化
• コマンド間でセッションを保持
• エラーメッセージと検証結果のフィードバックを強化

これまでの主なリリース

バージョン 0.3.1 — グローバルインストールと同期

• グローバル版とローカル版のバージョン同期に関する問題を修正
• インストール時のクリーンビルドプロセスを強化
• NPM 公開用のパッケージングワークフローを改善

バージョン 0.2.8 — CLI 対話モード

• 対話モードでの設定保持に関する問題を修正
• CLI ユーザー向けのプロジェクトルート検出を強化
• コンテキストを考慮した設定を改善

バージョン 0.2.3 — 対話型 REPL とセットアップウィザード

• チャット形式のインターフェースとセッション保持機能を備えた対話型 REPL モード
• 初回実行を自動検出する強化されたセットアップウィザード
• src/config-templates/ にある設定テンプレート
• メモリ使用量を最適化したパフォーマンス改善
• CLI バイナリを統合 — すべての操作を単一の vibe コマンドで実行

🚀 クイックスタート

# Install globally (recommended)
npm install -g vibe-coder-mcp@latest

# Run setup wizard on first use
vibe --setup

# Or use instantly with npx (no installation)
npx vibe-coder-mcp@latest --setup

セットアップウィザードでは、次の操作を行います：

1. ✅ OpenRouter API キーを設定
2. ✅ プロジェクトディレクトリをセットアップ
3. ✅ テンプレートから設定ファイルを作成
4. ✅ 環境を検証
5. ✅ すべての機能を利用できる状態に準備！

📦 インストール

# Recommended: Install globally for the 'vibe' command
npm install -g vibe-coder-mcp@latest

# Or run instantly without installation
npx vibe-coder-mcp@latest

インストール方法

グローバルインストール（推奨）

npm install -g vibe-coder-mcp@latest

# Use the 'vibe' command anywhere
vibe                                    # Start MCP server
vibe "create a PRD for a todo app"     # CLI mode
vibe --interactive                     # Interactive REPL mode
vibe --setup                           # Setup wizard

npx ですぐに実行

# No installation needed
npx vibe-coder-mcp@latest
npx vibe-coder-mcp@latest "research React best practices"

ローカルプロジェクトへのインストール

npm install vibe-coder-mcp
npx vibe-coder-mcp "map the codebase structure"

コマンドラインの使用

# MCP Server Mode (for Claude Desktop, Cursor, etc.)
vibe                                    # Start with stdio transport
vibe --sse                             # Start with Server-Sent Events

# CLI Mode - Natural Language Commands
vibe "research modern JavaScript frameworks"
vibe "create a PRD for an e-commerce platform"
vibe "map the codebase structure" --json
vibe "generate user stories for auth system"

# Interactive REPL Mode
vibe --interactive                     # Chat interface with context retention

# Configuration
vibe --setup                           # Run setup wizard
vibe --help                            # Show all options
vibe --version                         # Show version

インタラクティブモードの機能：

• コンテキストを保持するチャット形式の会話
• 進行状況インジケーター付きのリアルタイムなツール実行
• セッションの永続化と履歴
• Markdown のレンダリングに対応
• 複数のテーマとカスタマイズ
• クイックアクション用のスラッシュコマンド

🎯 MCP クライアント統合（Claude Desktop、Cursor、Cline AI）

クイック統合ガイド

Vibe-Coder MCP は、MCP 互換のあらゆるクライアントとシームレスに統合できます。設定方法は以下のとおりです。

オプション 1：NPX を使用（推奨）

MCP クライアントのサーバー設定ダイアログで、次のように設定します。

• サーバー名：vibe-coder-mcp
• コマンド／URL：npx
• 引数：vibe-coder-mcp
• 環境変数：
  • OPENROUTER_API_KEY：OpenRouter API キー（必須）
  • VIBE_PROJECT_ROOT：/path/to/your/project（必須）
  • LOG_LEVEL：info（任意）
  • NODE_ENV：production（任意）

オプション 2：グローバルインストール

# First install globally
npm install -g vibe-coder-mcp

次に、以下のように設定します。

• コマンド／URL：vibe
• 引数：（空欄のまま）
• 環境変数：オプション 1 と同じ

オプション 3：Node をフルパスで指定

• コマンド／URL：node
• 引数：/path/to/node_modules/vibe-coder-mcp/build/index.js
• 環境変数：オプション 1 と同じ

Claude Desktop 固有の設定

Claude Desktop のユーザーは、claude_desktop_config.json に以下を追加してください。

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "npx",
      "args": ["vibe-coder-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-openrouter-api-key",
        "VIBE_PROJECT_ROOT": "/path/to/your/project",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}

完全な例については、example_claude_desktop_config.json を参照してください。

統合後に利用できるツール

設定が完了すると、MCP クライアントから以下のツールを利用できます。

• vibe-task-manager：RDD 手法を用いた AI ネイティブなタスク管理
• research-manager：Perplexity との統合による詳細な調査
• map-codebase：高度なコードベース分析（35 以上の言語）
• curate-context：AI 開発向けのインテリジェントなコンテキスト整理
• generate-prd：製品要件定義書の生成ツール
• generate-user-stories：ユーザーストーリーの生成ツール
• generate-task-list：タスクリストの生成ツール
• generate-fullstack-starter-kit：プロジェクトのひな型作成ツール
• run-workflow：複数ステップのワークフロー実行

統合のテスト

設定後、AI アシスタントに以下のように依頼してテストします。

• 「vibe を使って React のベストプラクティスを調査してください」
• 「このプロジェクトのコードベースをマッピングしてください」
• 「タスク管理アプリの PRD を生成してください」

🆕 統合プロジェクトルート設定

CLI ユーザー向けのゼロ設定

# Automatic project detection - just run from your project!
cd /path/to/your/project
vibe "map the codebase structure"

MCP クライアント向けの簡単な設定

{
  "env": {
    "OPENROUTER_API_KEY": "your_key_here",
    "VIBE_PROJECT_ROOT": "/path/to/your/project"
  }
}

• 変数は 1 つだけ：VIBE_PROJECT_ROOT により、複数のディレクトリ設定を置き換えます
• 自動検出：CLI がプロジェクトルートを自動的に検出します
• 後方互換性：従来の変数も引き続きサポートされます

🔧 環境設定

必須： Vibe Coder MCP を使用するには、OpenRouter API キーが必要です。

OpenRouter API キーの取得

1. openrouter.ai にアクセスします
2. アカウントをお持ちでない場合は、作成します
3. API Keys セクションに移動します
4. 新しい API キーを作成してコピーします

環境変数の設定

オプション 1：セットアップウィザードを使用（v0.2.3 以降で推奨）

# Run the interactive setup wizard
vibe --setup

# The wizard will:
# • Configure your OpenRouter API key
# • Set up project directories
# • Create configuration files
# • Validate your setup

オプション 2：環境変数

# Set your OpenRouter API key
export OPENROUTER_API_KEY="your_api_key_here"

# Optional: Set custom directories
export VIBE_CODER_OUTPUT_DIR="/path/to/output/directory"
export VIBE_PROJECT_ROOT="/path/to/your/project"

# Legacy variables (still supported for backward compatibility)
export CODE_MAP_ALLOWED_DIR="/path/to/your/source/code"
export VIBE_TASK_MANAGER_READ_DIR="/path/to/your/project"

オプション 3：.env ファイルを作成（v0.2.3 以降ではテンプレートを提供） 作業ディレクトリに .env ファイルを作成します（または src/config-templates/.env.template からコピーします）。

# Required: Your OpenRouter API key
OPENROUTER_API_KEY="your_api_key_here"

# Optional: Unified project root configuration
VIBE_CODER_OUTPUT_DIR="/path/to/output/directory"
VIBE_PROJECT_ROOT="/path/to/your/project"
VIBE_USE_PROJECT_ROOT_AUTO_DETECTION="true"

# Legacy variables (still supported for backward compatibility)
CODE_MAP_ALLOWED_DIR="/path/to/your/source/code"  
VIBE_TASK_MANAGER_READ_DIR="/path/to/your/project"

# Optional: Other settings
OPENROUTER_BASE_URL="https://openrouter.ai/api/v1"
GEMINI_MODEL="google/gemini-2.5-flash-preview-05-20"

ディレクトリ設定（統一化と簡素化）

🆕 統一設定（推奨）

• VIBE_PROJECT_ROOT：すべてのプロジェクト操作に使用する単一の変数です（CLI ではデフォルトで自動検出が有効です）。
• VIBE_USE_PROJECT_ROOT_AUTO_DETECTION：CLI ユーザー向けにプロジェクトルートの自動検出を有効にします（デフォルト："true"）。
• VIBE_CODER_OUTPUT_DIR：生成ファイルの保存先です（デフォルト：./VibeCoderOutput/）。

従来の設定（引き続きサポート）

• CODE_MAP_ALLOWED_DIR：コード分析のセキュリティ境界です（VIBE_PROJECT_ROOT が設定されていない場合のフォールバック）。
• VIBE_TASK_MANAGER_READ_DIR：タスクマネージャー操作のセキュリティ境界です（VIBE_PROJECT_ROOT が設定されていない場合のフォールバック）。

自動検出のメリット：

• 設定不要：CLI ユーザーはプロジェクトルートを自動検出できます。
• コンテキストを認識：CLI と MCP クライアントの利用状況に応じて動作が変わります。
• インテリジェントなフォールバック：5 段階の優先順位に基づく解決チェーンにより、安定した動作を実現します。

🔌 MCP クライアントのセットアップ

Vibe Coder MCP に接続するように AI アシスタントを設定します。

Cursor AI / Windsurf / VS Code MCP クライアントの場合

MCP の設定（通常は settings.json）に以下を追加します。

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "npx",
      "args": ["vibe-coder-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop の場合

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "npx",
      "args": ["vibe-coder-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here",
        "VIBE_PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

💻 CLI の使用ガイド

Vibe Coder には、すべてのツールを直接操作するための複数のモードを備えた、強力なコマンドラインインターフェースが含まれています。

対話型セットアップウィザード（v0.2.3 で強化）

# First-time setup (runs automatically on first use)
vibe --setup

# Features:
# • Smart first-run detection
# • OS-specific configuration paths
# • Non-interactive mode for CI/CD
# • Configuration validation
# • Backup system for existing configs

# Reconfigure existing installation
vibe --reconfigure

対話型 REPL モード（v0.2.3 の新機能！）

# Start interactive chat session
vibe --interactive

# Or with alias
vibe -i

# Resume a previous session
vibe --resume <session-id>

REPL の機能：

• 🎯 チャットインターフェース：コンテキストを保持しながら、自然な会話形式でやり取りできます。
• 📝 複数行入力：複数行のメッセージには """ を使用します。
• 🎨 テーマ：/theme コマンドで複数の配色テーマを切り替えられます。
• 💾 セッション管理：自動保存と再開に対応しています。
• 📊 Markdown レンダリング：応答をリッチテキスト形式で表示します。
• ⚡ ライブ進捗：実行状況をリアルタイムでフィードバックします。
• 🔧 スラッシュコマンド：/tools、/history、/save などのクイックアクションを使用できます。
• 🎮 自動補完：コマンドとツールのタブ補完に対応しています。

CLI コマンドの例

リサーチと分析

vibe "research modern React patterns and best practices"
vibe "analyze current trends in microservices architecture"
vibe "research security best practices for Node.js APIs"

プロジェクト計画

vibe "create a PRD for an e-commerce platform with user authentication"
vibe "generate user stories for authentication system"
vibe "create development tasks from user stories"

コード分析と生成

vibe "map the codebase structure"
vibe "create context for implementing authentication"
vibe "generate a fullstack starter kit for e-commerce"
vibe "create coding standards for TypeScript projects"

タスク管理

vibe "create a new project for building a todo app"
vibe "list all my projects"
vibe "show project status for MyApp"
vibe "create high priority task for implementing OAuth"

CLI オプション

# Output formats
vibe "research React hooks" --json
vibe "create PRD for todo app" --yaml

# Verbosity control
vibe "create project MyApp" --verbose
vibe "research Node.js patterns" --quiet

# Interactive REPL mode (NEW!)
vibe --interactive
vibe -i

# Session management (NEW!)
vibe --resume <session-id>
vibe --list-sessions

対話型 REPL コマンド（v0.2.3 以降）

対話型モード（vibe --interactive）に入ったら、以下のコマンドを使用します。

# Help and navigation
/help              # Show available commands
/tools             # List all MCP tools
/status            # Show session status

# Session management
/save              # Save current session
/sessions          # List saved sessions
/export [file]     # Export session to markdown

# Conversation control
/clear             # Clear conversation history
/history           # Show conversation history

# Customization
/theme             # Change color theme
/markdown          # Toggle markdown rendering
/config            # Manage configuration

# Exit
/quit or /exit     # Exit interactive mode

ファイルの整理

生成されたファイルは VibeCoderOutput/ に自動的に整理されます。

VibeCoderOutput/
├── research/                    # Research reports
├── prd-generator/              # Product requirements
├── user-stories-generator/     # User stories
├── task-list-generator/        # Development tasks
├── fullstack-starter-kit-generator/  # Project templates
├── map-codebase/              # Code analysis
├── vibe-task-manager/         # Task management data
└── workflow-runner/           # Workflow outputs

---

🔄 移行ガイド（v0.2.3）

破壊的変更

ありません！ バージョン 0.2.3 は完全な後方互換性を備えています。既存のすべての設定とワークフローを引き続き使用できます。

技術的な改善

• CLI アーキテクチャを統一し、単一のエントリーポイントを採用
• エラー処理と復旧機能を改善
• リソースのクリーンアップを改善
• コードベース全体の型安全性を強化
• 長時間実行セッションでのメモリーリークを防止
• CI/CD パイプラインの最適化：
  • 実行時間を 70% 短縮（約 10 分から約 3 分に）
  • 型チェック、リンティング、ビルドなどの必須チェックに集中
  • 単体テストをローカル開発のワークフローに移行
  • 詳細は CI/CD ガイド を参照してください。
• 大規模なコードベースに合わせてメモリー使用量を最適化
• スマート検出により初回実行時の使い勝手を向上

---

📚 開発環境のセットアップ（上級者向け）

開発に貢献する場合やソースから実行する場合は、以下の詳細なセットアップガイドに従ってください。

概要と機能

Vibe Coder MCP は MCP 対応クライアントと連携し、以下の機能を提供します。

🚀 コアアーキテクチャ

• 4種類のトランスポートに対応：クライアントとの互換性を最大限に高める、stdio、SSE、WebSocket、HTTP のトランスポートプロトコル
• 動的なポート割り当て：競合の解決と適切な縮退運転を備えた、インテリジェントなポート管理
• セマンティックなリクエストルーティング：埋め込みベースのセマンティックマッチングと、順次思考によるフォールバックを使用して、リクエストをインテリジェントにルーティングします
• ツールレジストリアーキテクチャ：ツールが自己登録する、一元化されたツール管理
• 統合コミュニケーションプロトコル：リアルタイム通知を備え、すべてのトランスポート方式でエージェントを連携させます
• セッション状態管理：セッション内のリクエスト間でコンテキストを維持します

🧠 AI ネイティブなタスク管理

• Vibe Task Manager：99.9% のテスト成功率と包括的な統合を備えた、本番環境対応のタスク管理機能（動作しますが、現在も積極的に機能強化中です）
• 自然言語処理：複数の認識戦略（パターンマッチング＋LLM フォールバック）により、21 種類のインテントに対応します
• 再帰的分解設計（RDD）：プロジェクトをアトミックなタスクにインテリジェントに分解します
• エージェントオーケストレーション：機能のマッピング、負荷分散、リアルタイムのステータス同期によるマルチエージェント連携
• マルチトランスポートのエージェント対応：stdio、SSE、WebSocket、HTTP の各トランスポートに完全対応します
• 実ストレージとの統合：モックコードを一切使用しない方針で、すべて本番環境向けの統合を使用します
• アーティファクト解析との統合：PRD Generator と Task List Generator の出力にシームレスに統合します
• セッション永続化：オーケストレーションのワークフロートリガーを備えた、強化されたセッション追跡機能
• 包括的な CLI：豊富な機能を備えた自然言語のコマンドラインインターフェース

🔍 高度なコード分析とコンテキストのキュレーション

• Code Map Tool：35 以上のプログラミング言語に対応し、トークンを 95～97% 削減する最適化機能を備えています
• Context Curation Tool：35 以上の言語にわたるプロジェクトを 95% 以上の精度で検出する、言語に依存しない機能です
• インテリジェントなコードマップのキャッシュ：最近のコードマップを再利用してワークフローのパフォーマンスを最適化する、設定可能なキャッシュシステム
• 強化されたインポート解決：サードパーティとの統合により、依存関係を正確にマッピングします
• マルチ戦略のファイル検出：包括的な分析を実現する、4 つの並列戦略
• メモリの最適化：高度なキャッシュとリソース管理
• セキュリティ境界：安全な操作を実現する、読み取りパスと書き込みパスの個別検証

📋 調査・計画スイート

• Research Tool：OpenRouter 経由で Perplexity Sonar を使用した詳細な調査
• Context Curation：AI 主導の開発に向けた、8 フェーズのワークフローパイプラインとインテリジェントなコードマップキャッシュを備えた、コードベースのインテリジェントな分析
• ドキュメント生成ツール：PRD（prd-generator）、ユーザーストーリー（user-stories-generator）、タスクリスト（task-list-generator）、開発ルール（rules-generator）
• プロジェクトのスキャフォールディング：動的なテンプレート生成を備えた、フルスタックのスターターキット（fullstack-starter-kit-generator）
• ワークフロー実行：workflows.json で定義された、ツール呼び出しの事前定義済みシーケンス

⚡ パフォーマンスと信頼性

• 非同期実行：リアルタイムのステータス追跡を備えた、ジョブベースの処理
• パフォーマンスの最適化：応答時間 <200ms、メモリ使用量 <400MB
• 包括的なテスト：2,100 件以上のテストで 99.9% の成功率を達成し、統合全体を検証します
• 本番環境対応：モック実装を一切使用せず、実サービスと統合します
• 強化されたエラー処理：自動リトライ、エスカレーション、パターン分析を備えた高度なエラーリカバリー
• 動的なポート管理：競合の解決と適切な縮退運転を備えた、インテリジェントなポート割り当て
• リアルタイム監視：エージェントの健全性監視、タスク実行の追跡、パフォーマンス分析

（詳細は、以下の「詳細なツールドキュメント」と「機能の詳細」の各セクションをご覧ください）

開発環境のセットアップガイド

ソースから実行する、またはプロジェクトに貢献する開発者向けです。

ステップ 1：前提条件

1. Node.js のバージョンを確認する：

   • ターミナルまたはコマンドプロンプトを開きます。
   • node -v を実行します。
   • 出力が v20.0.0 以上であることを確認します（必須）。
   • インストールされていない場合、またはバージョンが古い場合：nodejs.org からダウンロードします。

2. Git のインストールを確認する：

   • ターミナルまたはコマンドプロンプトを開きます。
   • git --version を実行します。
   • インストールされていない場合：git-scm.com からダウンロードします。

3. OpenRouter API キーを取得する：

   • openrouter.ai にアクセスします。
   • アカウントをお持ちでない場合は、作成します。
   • API Keys セクションに移動します。
   • 新しい API キーを作成してコピーします。
   • ステップ 4 で使用するため、このキーを手元に用意しておきます。

ステップ 2：コードを取得する

1. プロジェクトディレクトリを作成する（任意）：

   • ターミナルまたはコマンドプロンプトを開きます。
   • プロジェクトを保存する場所に移動します。

     cd ~/Documents     # 例：任意の場所に移動
     

2. リポジトリをクローンする：

   • 次を実行します。

     git clone https://github.com/freshtechbro/vibe-coder-mcp.git
     

     （該当する場合は、フォークの URL を使用することもできます）

3. プロジェクトディレクトリに移動する：

   • 次を実行します。

     cd vibe-coder-mcp
     

ステップ 3：セットアップスクリプトを実行する

お使いのオペレーティングシステムに適したスクリプトを選択します。

Windows の場合：

1. ターミナルで（引き続き vibe-coder-mcp ディレクトリにいる状態で）、次を実行します。

   setup.bat
   

2. スクリプトが完了するまで待ちます（依存関係のインストール、プロジェクトのビルド、必要なディレクトリの作成が行われます）。
3. エラーメッセージが表示された場合は、以下の「トラブルシューティング」セクションを参照してください。

macOS または Linux の場合：

1. スクリプトを実行可能にします。

   chmod +x setup.sh
   

2. スクリプトを実行します。

   ./setup.sh
   

3. スクリプトが完了するまで待ちます。
4. エラーメッセージが表示された場合は、以下の「トラブルシューティング」セクションを参照してください。

スクリプトでは次の処理が行われます。

• Node.js のバージョンを確認します（v20 以上が必須）
• npm を使用してすべての依存関係をインストールします
• 必要な VibeCoderOutput/ サブディレクトリを作成します
• TypeScript プロジェクトをビルドします
• 存在しない場合は、テンプレートから設定を作成します（v0.2.3 以降）
• 実行権限を設定します（Unix システムの場合）

注：依存関係のインストールの最適化とビルドプロセスの簡素化により、セットアップが以前より速くなりました（v0.2.3 以降）。

ステップ 4：環境変数を設定する

v0.2.3 の新機能：簡単にセットアップできるよう、src/config-templates/ に設定テンプレートが用意されています。

オプション A：セットアップウィザードを使用する（推奨）

vibe --setup

ウィザードの案内に従って設定を行うと、必要なファイルがすべて作成されます。

オプション B：手動で設定する

1. テンプレートをコピーする（セットアップスクリプトでまだコピーされていない場合）：

   cp src/config-templates/.env.template .env
   cp src/config-templates/llm_config.template.json llm_config.json
   cp src/config-templates/mcp-config.template.json mcp-config.json
   

2. .env ファイルを編集して設定します：

   # OpenRouter Configuration (REQUIRED)
   OPENROUTER_API_KEY="your_actual_api_key_here"
   
   # Optional configurations
   OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
   GEMINI_MODEL=google/gemini-2.5-flash-preview-05-20
   
   # Project directories (optional - auto-detected for CLI users)
   VIBE_PROJECT_ROOT=/path/to/your/project
   VIBE_CODER_OUTPUT_DIR=/path/to/output
   

3. 出力ディレクトリを設定する（任意）：

   • 生成されたファイルの保存先を変更するには（デフォルトはプロジェクト内の VibeCoderOutput/ です）、.env ファイルに次の行を追加します：

     VIBE_CODER_OUTPUT_DIR=/path/to/your/desired/output/directory
     

   • パスを希望する絶対パスに置き換えます。パスにはスラッシュ（/）を使用します。この変数を設定しない場合は、デフォルトのディレクトリ（VibeCoderOutput/）が使用されます。

4. 🆕 統合プロジェクトルートを設定する（推奨）：

   • 新しい統合プロジェクトルートの設定を行うには、.env ファイルに次の行を追加します：

     VIBE_PROJECT_ROOT=/path/to/your/project/root
     

   • パスを、プロジェクトのルートディレクトリの絶対パスに置き換えます。
   • メリット：すべてのツール（Code Map Generator、Task Manager、Context Curator）に単一の設定変数を使用できます。
   • 自動検出：CLI ユーザーの場合、現在の作業ディレクトリからプロジェクトルートが自動的に検出されます。
   • 後方互換性：個別の設定を希望する場合は、従来の変数も引き続き使用できます。

5. 従来のディレクトリ設定（任意）：

   • ディレクトリを個別に設定する場合は、従来の変数も引き続き使用できます：

     CODE_MAP_ALLOWED_DIR=/path/to/your/source/code/directory
     VIBE_TASK_MANAGER_READ_DIR=/path/to/your/project/source/directory
     

   • 注：VIBE_PROJECT_ROOT が設定されていない場合、これらの変数がフォールバックとして機能します。
   • セキュリティ：すべての変数は、厳格なファイルシステムセキュリティ実装で機能します。

6. その他の設定を確認する（任意）：

   • LOG_LEVEL（例：LOG_LEVEL=debug）や NODE_ENV（例：NODE_ENV=development）など、サーバーがサポートする他の環境変数を追加できます。

7. .env ファイルを保存します。

ステップ 5：AI アシスタントと統合する（MCP 設定）

この重要な手順では、クライアントの MCP 設定ファイルに構成を追加して、Vibe Coder を AI アシスタントに接続します。

5.1：クライアントの MCP 設定ファイルを確認する

場所は、使用する AI アシスタントによって異なります：

• Cursor AI / Windsurf / RooCode（VS Code ベース）：

  1. アプリケーションを開きます。
  2. コマンドパレットを開きます（Ctrl+Shift+P または Cmd+Shift+P）。
  3. Preferences: Open User Settings (JSON) と入力して選択します。
  4. mcpServers オブジェクトが含まれる settings.json ファイルが開きます。

• Cline AI（VS Code 拡張機能）：

  • Windows：%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • macOS：~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Linux：~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • (注：Cursor ではなく通常の VS Code を使用する場合は、パス内の Cursor を Code に置き換えてください)

• Claude Desktop：

  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json

5.2: Vibe Coder の設定を追加する

1. 上記で確認した設定ファイルをテキストエディターで開きます。

2. "mcpServers": { ... } の JSON オブジェクトを探します。存在しない場合は、作成する必要があります（ファイル全体が有効な JSON のままになるようにしてください）。たとえば、空のファイルは {"mcpServers": {}} のようになります。

3. 次の設定ブロックを、mcpServers オブジェクトの波括弧 {} の内側に追加します。ほかのサーバーがすでに一覧にある場合は、このブロックを貼り付ける前に、直前のサーバーの閉じ波括弧 } の後にカンマ , を追加してください。

   // クライアントの設定内で、この MCP サーバーインスタンスを識別する一意の識別子です
   "vibe-coder-mcp": {
     // サーバーの実行に使用するコマンドを指定します。Node.js がシステムの PATH にある場合は 'node' にします
     "command": "node",
     // 'command' に渡す引数を指定します。主な引数は、コンパイル済みサーバーのエントリーポイントの絶対パスです
     // !! 重要：お使いのシステム上の実際の絶対パスに置き換えてください。Windows でもスラッシュ（/）を使用してください !!
     "args": ["/Users/username/Documents/Dev Projects/Vibe-Coder-MCP/build/index.js"],
     // サーバープロセスの実行時に使用する現在の作業ディレクトリを設定します
     // !! 重要：お使いのシステム上の実際の絶対パスに置き換えてください。Windows でもスラッシュ（/）を使用してください !!
     "cwd": "/Users/username/Documents/Dev Projects/Vibe-Coder-MCP",
     // クライアントとサーバー間の通信トランスポートプロトコルを定義します
     "transport": "stdio",
     // 起動時に Vibe Coder サーバープロセスに渡す環境変数です
     // API キーはここではなく、.env ファイルに記述してください
     "env": {
       // Vibe Coder が使用する LLM 設定ファイルの絶対パス
       // !! 重要：お使いのシステム上の実際の絶対パスに置き換えてください !!
       "LLM_CONFIG_PATH": "/Users/username/Documents/Dev Projects/Vibe-Coder-MCP/llm_config.json",
       // サーバーのログレベルを設定します
       "LOG_LEVEL": "debug",
       // 実行環境を指定します
       "NODE_ENV": "production",
       // Vibe Coder のツールが出力ファイルを保存するディレクトリ
       // !! 重要：お使いのシステム上の実際の絶対パスに置き換えてください !!
       "VIBE_CODER_OUTPUT_DIR": "/Users/username/Documents/Dev Projects/Vibe-Coder-MCP/VibeCoderOutput",
       // 🆕 すべてのツールに共通のプロジェクトルート（推奨）
       // この変数ひとつで、すべてのツールに同じプロジェクト境界を設定します
       "VIBE_PROJECT_ROOT": "/Users/username/Documents/Dev Projects/Vibe-Coder-MCP",
       // 従来の変数（任意。VIBE_PROJECT_ROOT が設定されていない場合のフォールバックとして使用）
       "CODE_MAP_ALLOWED_DIR": "/Users/username/Documents/Dev Projects/Vibe-Coder-MCP/src",
       "VIBE_TASK_MANAGER_READ_DIR": "/Users/username/Documents/Dev Projects/Vibe-Coder-MCP"
     },
     // このサーバー設定を有効（false）または無効（true）にするブール値フラグ
     "disabled": false,
     // MCP クライアントが自動実行を許可されているツール名の一覧
     "autoApprove": [
       "research",
       "rules-generator",
       "user-stories-generator",
       "task-list-generator",
       "prd-generator",
       "fullstack-starter-kit-generator",
       "refactor-code",
       "git-summary",
       "run-workflow",
       "map-codebase"
     ]
   }
   

4. 重要： /path/to/your/vibe-coder-mcp/... のようなすべてのプレースホルダーのパスを、リポジトリをクローンしたお使いのシステム上の正しい絶対パスに置き換えてください。Windows でもパスにはスラッシュ / を使用してください（例：C:/Users/YourName/Projects/vibe-coder-mcp/build/index.js）。パスの誤りは、サーバーが接続できない最も一般的な原因です。

5. 設定ファイルを保存します。

6. 変更を反映するため、AI アシスタントアプリケーション（Cursor、VS Code、Claude Desktop など）を完全に終了してから再起動してください。

ステップ 6：設定をテストする

1. AI アシスタントを起動します：

   • AI アシスタントアプリケーションを完全に再起動します。

2. 簡単なコマンドをテストします：

   • Research modern JavaScript frameworks のようなテストコマンドを入力します。

3. 応答が正しいことを確認します：

   • 正常に動作していれば、調査結果が返されます。
   • そうでない場合は、下記の「トラブルシューティング」セクションを確認してください。

AI エージェントとの統合

Vibe Coder MCP システムには、AI エージェントと MCP クライアントがエコシステム全体を効果的に活用できるよう設計された、包括的なシステム指示が含まれています。この指示では、ツールの使用方法、統合パターン、ベストプラクティスについて詳しく説明しています。

システム指示ファイル

VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md ファイルには、Vibe Coder MCP エコシステムを効果的に活用する方法について、AI エージェント向けの包括的なガイダンスが記載されています。このファイルを AI 開発環境に組み込み、最適なツールの使用方法をエージェントに学習させてください。

プラットフォーム固有の統合

Claude Desktop

システム指示またはカスタム指示として、システム指示をプロジェクトに追加します：

1. Claude Desktop を開きます
2. プロジェクト設定に移動します
3. VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md の内容をシステム指示欄に追加します
4. 保存して Claude Desktop を再起動します

ChatGPT

システム指示をカスタム指示またはプロジェクト設定に追加します：

1. ChatGPT の設定を開きます
2. カスタム指示またはプロジェクト設定に移動します
3. VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md の内容を貼り付けます
4. 設定を保存します

VS Code 拡張機能（Cline、Roo Coder、Augment）

システム指示を拡張機能の設定に組み込みます：

1. Cline：システム指示またはメモリーセクションに配置します
2. Roo Coder：システム指示またはルールフォルダーに追加します
3. Augment：システム指示またはメモリーに配置します
4. その他の VS Code フォーク：「常に有効」の設定を有効にして、システム指示またはルールフォルダーに配置します

一般的な MCP クライアント

その他の MCP 対応クライアントの場合：

1. システム指示またはルールの設定を探します
2. VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md の内容を追加します
3. オプションがある場合は、「常に有効」または「永続」に設定します
4. クライアントを再起動して変更を適用します

主な統合のメリット

• 包括的なツールの知識：エージェントが、利用可能な 15 以上のすべてのツールとその機能について学習します
• ワークフローのオーケストレーション：複雑な開発ワークフローでツールを連携させる方法を案内します
• ジョブのポーリングプロトコル：非同期操作を正しく処理するための重要な指示です
• ベストプラクティス：パフォーマンス最適化とエラー処理の戦略です
• 統合パターン：調査、計画、実装の一般的なワークフローです

使用例

統合すると、AI エージェントは次のことができるようになります：

# Research-driven development
"Research modern React patterns, then create a PRD and generate user stories"

# Complete project setup
"Set up a new e-commerce project with React frontend and Node.js backend"

# Context-aware development
"Analyze this codebase and suggest improvements with implementation tasks"

# Multi-agent coordination
"Register frontend and backend agents, then distribute authentication tasks"

統合の確認

統合が成功したことを確認するには：

1. 利用可能な Vibe Coder ツールについて AI エージェントに尋ねます
2. 複数のツールを順番に使用するワークフローを依頼します
3. エージェントが適切なジョブのポーリングプロトコルに従っていることを確認します
4. 出力が正しいディレクトリに保存されていることを確認します

🎯 統合 CLI アーキテクチャ（v0.2.3+）

新しい統合 CLI（unified-cli.ts）は、すべての Vibe Coder 操作への単一のエントリーポイントを提供します：

flowchart TD
    Start[vibe command] --> Detect{First Run?}
    Detect -->|Yes| Setup[Setup Wizard]
    Detect -->|No| Parse[Parse Arguments]
    
    Setup --> Config[Save Configuration]
    Config --> Parse
    
    Parse --> Mode{Mode?}
    Mode -->|--interactive| REPL[Interactive REPL]
    Mode -->|"message"| CLI[CLI Execution]
    Mode -->|none| MCP[MCP Server]
    Mode -->|--setup| Setup
    
    REPL --> Session[Session Management]
    Session --> Chat[Chat Interface]
    Chat --> Tools[Tool Execution]
    
    CLI --> Router[Hybrid Router]
    Router --> Tools
    
    MCP --> Transport{Transport?}
    Transport -->|stdio| Stdio[Stdio Server]
    Transport -->|sse| SSE[SSE Server]

統合 CLI のメリット：

• すべての操作で単一のバイナリ（vibe）
• 一貫したコマンドインターフェース
• 共有設定管理
• シームレスなモード切り替え
• リソースのより効率的な利用

プロジェクトアーキテクチャ

Vibe Coder MCP サーバーは、デュアルトランスポートに対応し、包括的なツールエコシステムを備えたモジュール式 TypeScript ESM アーキテクチャを採用しています：

flowchart TD
    subgraph "Core Architecture"
        Init[index.ts] --> Config[Configuration Loader]
        Config --> Transport{Transport Type}
        Transport --> |stdio| StdioTransport[Stdio Transport]
        Transport --> |sse| SSETransport[SSE Transport]
        StdioTransport --> Server[MCP Server]
        SSETransport --> Server
        Server --> ToolReg[Tool Registry]
        ToolReg --> InitEmbed[Initialize Embeddings]
        InitEmbed --> Ready[Server Ready]
    end

    subgraph "Request Processing"
        Req[Client Request] --> SessionMgr[Session Manager]
        SessionMgr --> Router[Hybrid Router]
        Router --> Semantic[Semantic Matcher]
        Router --> Sequential[Sequential Thinking]
        Semantic --> |High Confidence| Execute[Tool Execution]
        Sequential --> |Fallback| Execute
        Execute --> JobMgr[Job Manager]
        JobMgr --> Response[Response to Client]
    end

    subgraph "Tool Ecosystem"
        Execute --> Research[Research Tool]
        Execute --> TaskMgr[Vibe Task Manager]
        Execute --> CodeMap[Code Map Tool]
        Execute --> FullStack[Fullstack Generator]
        Execute --> PRDGen[PRD Generator]
        Execute --> UserStories[User Stories Generator]
        Execute --> TaskList[Task List Generator]
        Execute --> Rules[Rules Generator]
        Execute --> Workflow[Workflow Runner]
    end

    subgraph "Support Services"
        JobMgr --> AsyncJobs[Async Job Processing]
        Execute --> FileOps[File Operations]
        Execute --> LLMHelper[LLM Integration]
        Execute --> ErrorHandler[Error Handling]
        Execute --> StateManager[Session State]
    end

    subgraph "Configuration & Security"
        Config --> LLMConfig[LLM Config Mapping]
        Config --> MCPConfig[MCP Tool Config]
        Config --> EnvVars[Environment Variables]
        FileOps --> SecurityBoundary[Security Boundaries]
        SecurityBoundary --> ReadOps[Read Operations]
        SecurityBoundary --> WriteOps[Write Operations]
    end

ディレクトリ構造

vibe-coder-mcp/
├── .env                              # Environment configuration
├── .env.example                      # Environment template
├── llm_config.json                   # LLM model mappings
├── mcp-config.json                   # MCP tool configurations
├── package.json                      # Project dependencies
├── README.md                         # This documentation
├── VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md  # System prompt documentation
├── setup.bat                         # Windows setup script
├── setup.sh                          # macOS/Linux setup script
├── tsconfig.json                     # TypeScript configuration
├── vitest.config.ts                  # Vitest (testing) configuration
├── workflows.json                    # Workflow definitions
├── build/                            # Compiled JavaScript (after build)
├── docs/                             # Additional documentation
│   ├── map-codebase/                # Code Map Tool docs
│   ├── handover/                     # Development handover docs
│   └── *.md                          # Various documentation files
├── VibeCoderOutput/                  # Tool output directory
│   ├── research/                    # Research reports
│   ├── rules-generator/              # Development rules
│   ├── prd-generator/                # Product requirements
│   ├── user-stories-generator/       # User stories
│   ├── task-list-generator/          # Task lists
│   ├── fullstack-starter-kit-generator/  # Project templates
│   ├── map-codebase/                # Code maps and diagrams
│   ├── vibe-task-manager/            # Task management data
│   └── workflow-runner/              # Workflow outputs
└── src/                              # Source code
    ├── index.ts                      # Entry point
    ├── logger.ts                     # Logging configuration (Pino)
    ├── server.ts                     # MCP server setup
    ├── services/                     # Core services
    │   ├── routing/                  # Semantic routing system
    │   │   ├── embeddingStore.ts     # Embedding management
    │   │   ├── hybridMatcher.ts      # Hybrid routing logic
    │   │   └── toolRegistry.ts       # Tool registry
    │   ├── sse-notifier/             # SSE notification system
    │   ├── JobManager.ts             # Async job management
    │   └── ToolService.ts            # Tool execution service
    ├── tools/                        # MCP Tools
    │   ├── index.ts                  # Tool registration
    │   ├── sequential-thinking.ts    # Fallback routing
    │   ├── map-codebase/            # Code analysis tool
    │   │   ├── cache/                # Memory management
    │   │   ├── grammars/             # Tree-sitter grammars
    │   │   ├── importResolvers/      # Import resolution adapters
    │   │   └── *.ts                  # Core implementation
    │   ├── fullstack-starter-kit-generator/  # Project scaffolding
    │   ├── prd-generator/            # PRD creation
    │   ├── research/                # Research tool
    │   ├── rules-generator/          # Rule generation
    │   ├── task-list-generator/      # Task list generation
    │   ├── user-stories-generator/   # User story generation
    │   ├── vibe-task-manager/        # AI-native task management
    │   │   ├── __tests__/            # Comprehensive test suite
    │   │   ├── cli/                  # Command-line interface
    │   │   ├── core/                 # Core algorithms
    │   │   ├── integrations/         # Tool integrations
    │   │   ├── prompts/              # LLM prompts (YAML)
    │   │   ├── services/             # Business logic services
    │   │   ├── types/                # TypeScript definitions
    │   │   └── utils/                # Utility functions
    │   └── workflow-runner/          # Workflow execution engine
    ├── types/                        # TypeScript type definitions
    └── utils/                        # Shared utilities
        ├── configLoader.ts           # Configuration management
        ├── errors.ts                 # Error handling
        └── llmHelper.ts              # LLM integration helpers

セマンティックルーティングシステム

Vibe Coder は、各リクエストに適切なツールを選択するために、高度なルーティング方式を使用します：

flowchart TD
    Start[Client Request] --> Process[Process Request]
    Process --> Hybrid[Hybrid Matcher]

    subgraph "Primary: Semantic Routing"
        Hybrid --> Semantic[Semantic Matcher]
        Semantic --> Embeddings[Query Embeddings]
        Embeddings --> Tools[Tool Embeddings]
        Tools --> Compare[Compare via Cosine Similarity]
        Compare --> Score[Score & Rank Tools]
        Score --> Confidence{High Confidence?}
    end

    Confidence -->|Yes| Registry[Tool Registry]

    subgraph "Fallback: Sequential Thinking"
        Confidence -->|No| Sequential[Sequential Thinking]
        Sequential --> LLM[LLM Analysis]
        LLM --> ThoughtChain[Thought Chain]
        ThoughtChain --> Extraction[Extract Tool Name]
        Extraction --> Registry
    end

    Registry --> Executor[Execute Tool]
    Executor --> Response[Return Response]

ツールレジストリパターン

ツールレジストリは、ツールの定義と実行を管理するための中心的なコンポーネントです：

flowchart TD
    subgraph "Tool Registration (at import)"
        Import[Import Tool] --> Register[Call registerTool]
        Register --> Store[Store in Registry Map]
    end

    subgraph "Tool Definition"
        Def[ToolDefinition] --> Name[Tool Name]
        Def --> Desc[Description]
        Def --> Schema[Zod Schema]
        Def --> Exec[Executor Function]
    end

    subgraph "Server Initialization"
        Init[server.ts] --> Import
        Init --> GetAll[getAllTools]
        GetAll --> Loop[Loop Through Tools]
        Loop --> McpReg[Register with MCP Server]
    end

    subgraph "Tool Execution"
        McpReg --> ExecTool[executeTool Function]
        ExecTool --> GetTool[Get Tool from Registry]
        GetTool --> Validate[Validate Input]
        Validate -->|Valid| ExecFunc[Run Executor Function]
        Validate -->|Invalid| ValidErr[Return Validation Error]
        ExecFunc -->|Success| SuccessResp[Return Success Response]
        ExecFunc -->|Error| HandleErr[Catch & Format Error]
        HandleErr --> ErrResp[Return Error Response]
    end

順次思考プロセス

順次思考メカニズムは、LLM ベースのフォールバックルーティングを提供します。

flowchart TD
    Start[Start] --> Estimate[Estimate Number of Steps]
    Estimate --> Init[Initialize with System Prompt]
    Init --> First[Generate First Thought]
    First --> Context[Add to Context]
    Context --> Loop{Needs More Thoughts?}

    Loop -->|Yes| Next[Generate Next Thought]
    Next -->|Standard| AddStd[Add to Context]
    Next -->|Revision| Rev[Mark as Revision]
    Next -->|New Branch| Branch[Mark as Branch]
    Rev --> AddRev[Add to Context]
    Branch --> AddBranch[Add to Context]
    AddStd --> Loop
    AddRev --> Loop
    AddBranch --> Loop

    Loop -->|No| Extract[Extract Final Solution]
    Extract --> End[End With Tool Selection]

    subgraph "Error Handling"
        Next -->|Error| Retry[Retry with Simplified Request]
        Retry -->|Success| AddRetry[Add to Context]
        Retry -->|Failure| FallbackEx[Extract Partial Solution]
        AddRetry --> Loop
        FallbackEx --> End
    end

セッション状態の管理

flowchart TD
    Start[Client Request] --> SessionID[Extract Session ID]
    SessionID --> Store{State Exists?}

    Store -->|Yes| Retrieve[Retrieve Previous State]
    Store -->|No| Create[Create New State]

    Retrieve --> Context[Add Context to Tool]
    Create --> NoContext[Execute Without Context]

    Context --> Execute[Execute Tool]
    NoContext --> Execute

    Execute --> SaveState[Update Session State]
    SaveState --> Response[Return Response to Client]

    subgraph "Session State Structure"
        State[SessionState] --> PrevCall[Previous Tool Call]
        State --> PrevResp[Previous Response]
        State --> Timestamp[Timestamp]
    end

ワークフロー実行エンジン

ワークフローシステムでは、複数ステップのシーケンスを実行できます。

flowchart TD
    Start[Client Request] --> Parse[Parse Workflow Request]
    Parse --> FindFlow[Find Workflow in workflows.json]
    FindFlow --> Steps[Extract Steps]

    Steps --> Loop[Process Each Step]
    Loop --> PrepInput[Prepare Step Input]
    PrepInput --> ExecuteTool[Execute Tool via Registry]
    ExecuteTool --> SaveOutput[Save Step Output]
    SaveOutput --> NextStep{More Steps?}

    NextStep -->|Yes| MapOutput[Map Output to Next Input]
    MapOutput --> Loop

    NextStep -->|No| FinalOutput[Prepare Final Output]
    FinalOutput --> End[Return Workflow Result]

    subgraph "Input/Output Mapping"
        MapOutput --> Direct[Direct Value]
        MapOutput --> Extract[Extract From Previous]
        MapOutput --> Transform[Transform Values]
    end

ワークフローの設定

ワークフローは、プロジェクトのルートディレクトリにある workflows.json ファイルで定義します。このファイルには、単一のコマンドで実行できる、事前に定義されたツール呼び出しのシーケンスが含まれています。

ファイルの場所と構成

• workflows.json ファイルは、プロジェクトのルートディレクトリ（package.json と同じ階層）に配置する必要があります
• ファイルは次の構成に従います：

  {
    "workflows": {
      "workflowName1": {
        "description": "Description of what this workflow does",
        "inputSchema": {
          "param1": "string",
          "param2": "string"
        },
        "steps": [
          {
            "id": "step1_id",
            "toolName": "tool-name",
            "params": {
              "param1": "{workflow.input.param1}"
            }
          },
          {
            "id": "step2_id",
            "toolName": "another-tool",
            "params": {
              "paramA": "{workflow.input.param2}",
              "paramB": "{steps.step1_id.output.content[0].text}"
            }
          }
        ],
        "output": {
          "summary": "Workflow completed message",
          "details": ["Output line 1", "Output line 2"]
        }
      }
    }
  }
  

パラメータテンプレート

ワークフローのステップパラメータでは、次を参照するテンプレート文字列を使用できます。

• ワークフロー入力：{workflow.input.paramName}
• 前のステップの出力：{steps.stepId.output.content[0].text}

ワークフローの実行

次の内容で run-workflow ツールを使用します。

Run the newProjectSetup workflow with input {"productDescription": "A task manager app"}

ツールの詳細なドキュメント

src/tools/ ディレクトリ内の各ツールには、それぞれの README.md ファイルに詳細なドキュメントが記載されています。これらのファイルでは、次の内容を説明しています。

• ツールの概要と目的
• 入力／出力の仕様
• ワークフロー図（Mermaid）
• 使用例
• 使用されるシステムプロンプト
• エラー処理の詳細

詳しい情報については、各 README を参照してください。

• src/tools/fullstack-starter-kit-generator/README.md
• src/tools/prd-generator/README.md
• src/tools/research/README.md
• src/tools/rules-generator/README.md
• src/tools/task-list-generator/README.md
• src/tools/user-stories-generator/README.md
• src/tools/workflow-runner/README.md
• src/tools/map-codebase/README.md

ツールのカテゴリー

分析・情報ツール

• コードマップツール（map-codebase）：コードベースをスキャンして、意味情報（クラス、関数、コメント）を抽出します。また、Mermaid 図を含む人が読みやすい Markdown マップ、またはインポートの絶対ファイルパスや強化されたクラスプロパティ情報を含む構造化 JSON 表現を生成します。
• コンテキストキュレーションツール（curate-context）：8 フェーズのワークフローパイプラインによるインテリジェントなコードベース分析とコンテキストパッケージのキュレーション、インテリジェントなコードマップのキャッシュ、35 以上のプログラミング言語に対応した言語に依存しないプロジェクト検出、AI 主導の開発タスク向けの複数の戦略を用いたファイル検出を提供します。
• リサーチツール（research）：Perplexity Sonar を使用して技術的なトピックを詳細に調査し、要約と情報源を提供します。

計画・ドキュメント作成ツール

• **ルールジェネレーター（rules-generator）：**プロジェクト固有の開発ルールとガイドラインを作成します。
• **PRD ジェネレーター（prd-generator）：**包括的な製品要件ドキュメントを生成します。
• **ユーザーストーリージェネレーター（user-stories-generator）：**受け入れ条件を含む詳細なユーザーストーリーを作成します。
• **タスクリストジェネレーター（task-list-generator）：**依存関係を含む構造化された開発タスクリストを作成します。

プロジェクトスキャフォールディングツール

• **フルスタック スターターキットジェネレーター（fullstack-starter-kit-generator）：**指定されたフロントエンド／バックエンド技術を使用して、基本的なセットアップスクリプトと設定を含む、カスタマイズされたプロジェクトスターターキットを作成します。

ワークフロー・オーケストレーション

• **ワークフローランナー（run-workflow）：**一般的な開発タスク向けに、事前定義されたツール呼び出しのシーケンスを実行します。

生成ファイルの保存

デフォルトでは、ジェネレーターツールの出力は履歴参照用として、プロジェクト内の VibeCoderOutput/ ディレクトリに保存されます。この保存先は、.env ファイルまたは AI アシスタントの設定で VIBE_CODER_OUTPUT_DIR 環境変数を設定すると変更できます。

読み取り操作と書き込み操作のセキュリティ境界

セキュリティ上の理由から、Vibe Coder MCP ツールはデフォルトで安全なアプローチを採用し、読み取り操作と書き込み操作に個別のセキュリティ境界を設けています。

• 読み取り操作：

  • Code Map Tool：CODE_MAP_ALLOWED_DIR 環境変数で明示的に許可されたディレクトリからのみ読み取ります
  • Vibe Task Manager：VIBE_TASK_MANAGER_READ_DIR 環境変数で許可されたディレクトリからのみ読み取ります（デフォルトは process.cwd() です）
  • セキュリティモード：Vibe Task Manager はデフォルトで「strict」セキュリティモードになっており、/private/var/spool/postfix/、/System/ などのシステムディレクトリや、許可されていないその他のパスへのアクセスを防ぎます
  • ファイルシステムのセキュリティ：包括的なブラックリストの適用と権限チェックにより、EACCES エラーや許可されていないファイルへのアクセスを防ぎます

• 書き込み操作：すべての出力ファイルは VIBE_CODER_OUTPUT_DIR ディレクトリ（またはそのサブディレクトリ）に書き込まれます。この分離により、ツールが指定された出力先にのみ書き込めるようになり、ソースコードを誤って変更することを防ぎます。

• セキュリティの実装：ファイルシステムのセキュリティシステムには、次の機能が含まれています。

  • タイムアウトの適応的な管理：インテリジェントな再試行とキャンセルにより、操作が無期限に停止することを防ぎます
  • パスの検証：アクセス前に、すべてのファイルパスを包括的に検証します
  • 権限チェック：アクセスエラーを防ぐため、事前に権限を確認します
  • システムディレクトリの保護：決してアクセスしてはならないシステムディレクトリのブラックリストが組み込まれています

例の構成（デフォルトの場所）：

VibeCoderOutput/
  ├── research/                # Research reports
  │   └── TIMESTAMP-QUERY-research.md
  ├── rules-generator/          # Development rules
  │   └── TIMESTAMP-PROJECT-rules.md
  ├── prd-generator/            # PRDs
  │   └── TIMESTAMP-PROJECT-prd.md
  ├── user-stories-generator/   # User stories
  │   └── TIMESTAMP-PROJECT-user-stories.md
  ├── task-list-generator/      # Task lists
  │   └── TIMESTAMP-PROJECT-task-list.md
  ├── fullstack-starter-kit-generator/  # Project templates
  │   └── TIMESTAMP-PROJECT/
  ├── map-codebase/            # Code maps and diagrams
  │   └── TIMESTAMP-code-map/
  └── workflow-runner/          # Workflow outputs
      └── TIMESTAMP-WORKFLOW/

MCP クライアント向けのシステム指示

AI アシスタントや MCP クライアントで最適なパフォーマンスを得るには、VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md に記載された包括的なシステム指示を使用してください。このドキュメントには、次の詳細なガイダンスが含まれています。

• ツール固有の使用パターンとベストプラクティス
• 自然言語コマンドの構成
• 非同期ジョブのポーリングに関するガイドライン
• 統合ワークフローと例
• エラー処理とトラブルシューティング

システム指示の使用方法

Claude Desktop の場合：

1. Claude Desktop の設定を開きます
2. 「Custom Instructions」または「System Prompt」に移動します
3. VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md の内容全体をコピーします
4. カスタム指示のフィールドに貼り付けます
5. 設定を保存します

Augment の場合：

1. Augment の設定／環境設定を開きます
2. 「Custom Instructions」または「System Configuration」を探します
3. システム指示をコピーして貼り付けます
4. 変更を適用します

Claude Code／Windsurf／その他の MCP クライアントの場合：

1. カスタム指示またはシステムプロンプトの設定箇所を探します
2. VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md の内容をコピーします
3. 適切なフィールドに貼り付けます
4. 設定を保存／適用します

システム指示を使用するメリット：

• ツール操作の成功率が 98％ 以上
• 自然言語コマンドを最適に認識
• 非同期ジョブを適切に処理
• ワークフローを効率的にオーケストレーション
• エラーを減らし、トラブルシューティングを改善

使用例

CLI 経由（コマンドラインから直接実行）

# Research and analysis
vibe "research modern JavaScript frameworks"
vibe "create development rules for a mobile banking application"

# Project planning
vibe "generate a PRD for a task management application"
vibe "generate user stories for an e-commerce website"
vibe "create a task list for a weather app based on user stories"

# Code generation and analysis
vibe "create a starter kit for a React/Node.js blog application with user authentication"
vibe "map the codebase structure" --json
vibe "curate context for adding authentication to my React app"

# Task management
vibe "create a new project for building a todo app"
vibe "list all my projects"
vibe "show status of my React project"

# Workflow automation
vibe "run workflow newProjectSetup with input {\"projectName\": \"my-new-app\"}"

MCP クライアント経由（AI アシスタントとの統合）

接続済みの AI アシスタントを通じて、ツールを操作できます。

• リサーチ： Research modern JavaScript frameworks
• ルールの生成： Create development rules for a mobile banking application
• PRD の生成： Generate a PRD for a task management application
• ユーザーストーリーの生成： Generate user stories for an e-commerce website
• タスクリストの生成： Create a task list for a weather app based on [user stories]
• 逐次的な思考： Think through the architecture for a microservices-based e-commerce platform
• フルスタックのスターターキット： Create a starter kit for a React/Node.js blog application with user authentication
• ワークフローの実行： Run workflow newProjectSetup with input { "projectName": "my-new-app", "description": "A simple task manager" }
• コードベースのマッピング： Generate a code map for the current project、map-codebase path="./src"、または Generate a JSON representation of the codebase structure with output_format="json"
• コンテキストの選定： Curate context for adding authentication to my React app、Generate context package for refactoring the user service、または Analyze this codebase for performance optimization opportunities
• Vibe Task Manager： Create a new project for building a todo app、List all my projects、Run task authentication-setup、What's the status of my React project?

Vibe Task Manager - AI ネイティブなタスク管理

Vibe Task Manager は、AI エージェントと開発ワークフロー向けに特化して設計された、包括的なタスク管理システムです。インテリジェントなプロジェクト分解、自然言語コマンドの処理、他の Vibe Coder ツールとのシームレスな統合を提供します。

ステータス：テスト成功率 99.9% で機能しており、本番環境で利用可能ですが、新機能と改善を積極的に追加しています。

主な機能

• 自然言語処理：「React アプリを作るためのプロジェクトを作成して」や「保留中のタスクをすべて表示して」などのコマンドを理解します。
• 再帰的分解設計（RDD）：複雑なプロジェクトを、実行可能なアトミックタスクに自動的に分解します。
• 成果物解析の統合：VibeCoderOutput/prd-generator/ の PRD ファイルや、VibeCoderOutput/generated_task_lists/ のタスクリストをシームレスにインポートします。
• セッションの永続化：信頼性の高い複数ステップ操作を実現するため、オーケストレーションワークフローのトリガーを備えたセッション追跡を強化しました。
• 包括的な CLI：自然言語処理と構造化コマンドを備えた、完全なコマンドラインインターフェースです。
• エージェントのオーケストレーション：複数の AI エージェントを調整し、タスクを並列実行します。
• 統合に対応：Code Map Tool、Research Tool、その他のツールとシームレスに連携します。
• ファイルストレージ：確立された規則に従い、すべてのプロジェクトデータを VibeCoderOutput/vibe-task-manager/ に保存します。

クイックスタートの例

# Project Management
"Create a new project for building a todo app with React and Node.js"
"List all my projects"
"Show me the status of my web app project"

# Task Management
"Create a high priority task for implementing user authentication"
"List all pending tasks for the todo-app project"
"Run the database setup task"

# Project Analysis (Enhanced with Intelligent Lookup)
"Decompose my React project into development tasks"
"Decompose PID-TODO-APP-REACT-001 into tasks"  # Using project ID
"Decompose \"Todo App with React\" into tasks"  # Using exact name
"Decompose todo into tasks"  # Using partial name (fuzzy matching)
"Refine the authentication task to include OAuth support"
"What's the current progress on my mobile app?"

🎯 強化されたプロジェクト検索機能

• インテリジェントな解析：プロジェクト ID、名前、部分一致を自動的に検出します。
• 包括的な検証：分解を行う前に、プロジェクトの準備状況を検証します。
• 強化されたエラーメッセージ：利用可能なプロジェクトや使用例を示し、実行可能なガイダンスを提供します。
• 複数の入力形式：プロジェクト ID、引用符で囲まれた名前、部分的な名前、ファジーマッチングに対応します。
• 信頼度スコア：解析の信頼度を表示し、ユーザーへのフィードバックを向上させます。

コマンド構造

Vibe Task Manager は、構造化コマンドと自然言語の両方をサポートしています。

構造化コマンド：

• vibe-task-manager create project "Name" "Description" --options
• vibe-task-manager list projects --status pending
• vibe-task-manager run task task-id --force
• vibe-task-manager status project-id --detailed

自然言語（推奨）：

• 「[説明] のプロジェクトを作成して」
• 「[ステータス] のプロジェクトをすべて表示して」
• 「[タスク名] のタスクを実行して」
• 「[プロジェクト] のステータスは？」
• 「[プロジェクト名] の PRD ファイルを解析して」（新機能）
• 「[ファイルパス] からタスクリストをインポートして」（新機能）
• 「すべての PRD を解析して、プロジェクトを自動作成して」（新機能）

詳細なドキュメントについては、src/tools/vibe-task-manager/README.md と VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md のシステム指示を参照してください。

実装状況とパフォーマンス指標

現在のエピックの状況

Vibe Coder MCP プロジェクトは、包括的な進捗管理を行うエピックベースの開発アプローチを採用しています。

gantt
    title Vibe Coder MCP Development Progress
    dateFormat  YYYY-MM-DD
    section Core Infrastructure
    Tool Registry & Routing    :done, epic1, 2024-01-01, 2024-02-15
    MCP Server Implementation  :done, epic2, 2024-01-15, 2024-03-01
    Async Job Management       :done, epic3, 2024-02-15, 2024-03-15

    section Tool Development
    Research & Planning Tools  :done, epic4, 2024-02-01, 2024-04-01
    Code Map Tool              :done, epic5, 2024-03-01, 2024-05-15
    Vibe Task Manager Core     :done, epic6, 2024-04-01, 2024-06-15

    section Advanced Features
    Performance Optimization   :active, epic7, 2024-06-01, 2024-07-15
    Security Implementation    :epic8, 2024-07-01, 2024-08-15
    Analytics & Monitoring     :epic9, 2024-07-15, 2024-09-01

エピック完了状況の概要

• Epic 1-5：✅ 完了（100% - コアインフラストラクチャと基本ツール）
• Epic 6.1：✅ 完了（テスト成功率 98.3% - MCP ツールの詳細な統合）
• Epic 6.2：🔄 進行中（パフォーマンス最適化 - 75% 完了）
• Epic 7.1：📋 計画済み（セキュリティ実装 - 実装準備完了）
• Epic 8：📋 計画済み（高度な分析と監視 - 設計済み）

パフォーマンス目標と現在の指標（v0.2.3）

指標	目標	現在	状況
テスト成功率	98%+	99.9%	✅ 目標超過
応答時間（タスク操作）	<200ms	<150ms	✅ 目標超過
応答時間（同期操作）	<500ms	<350ms	✅ 目標超過
ジョブ完了率	95%+	96.7%	✅ 達成
メモリ使用量（Code Map Tool）	<512MB	<400MB	✅ 最適化済み
単体テストのカバレッジ	>70%	73%	✅ 達成
CI/CD パイプラインの速度	<5min	~3min	✅ 最適化済み
セキュリティによるオーバーヘッド	<50ms	<35ms	✅ 最適化済み
モックコードを使用しない方針	100%	100%	✅ 達成

ツールごとの状況

Vibe Task Manager

• 状況：本番環境で利用可能（機能は整っていますが、現在も積極的に機能強化中です）
• テストカバレッジ：99.9%
• 機能：RDD 手法、エージェントのオーケストレーション、自然言語処理、アーティファクトの解析、セッションの永続化、包括的な CLI
• パフォーマンス：タスク操作の応答時間 <50ms
• 最近の追加機能：PRD／タスクリストとの連携、セッション追跡の強化、オーケストレーションワークフロー

Code Map Tool

• 状況：高度な機能を備え、本番環境で利用可能
• メモリ最適化：トークンを 95～97% 削減
• 言語サポート：35 以上のプログラミング言語
• インポート解決：アダプターベースのアーキテクチャにより強化

Context Curation Tool

• 状況：インテリジェントなコードマップキャッシュ機能を備え、本番環境で利用可能
• 言語サポート：35 以上のプログラミング言語に対応し、精度は 95% 以上
• ワークフローパイプライン：8 段階のインテリジェントな分析とキュレーション
• プロジェクト検出：言語に依存せず、複数の方法でファイルを検出
• パフォーマンス最適化：設定可能な 1～1440 分の間で最近使用されたコードマップを再利用するインテリジェントキャッシュシステム

Research Tool

• 状況：本番環境で利用可能
• 連携：Perplexity Sonar API
• パフォーマンス：調査クエリの平均応答時間 <2 秒

その他のツール

• Fullstack Generator：本番環境で利用可能
• PRD／ユーザーストーリー／タスクリストのジェネレーター：本番環境で利用可能
• Workflow Runner：本番環境で利用可能

ローカルでの実行（任意）

主な用途は AI アシスタントとの統合（stdio を使用）ですが、テスト目的でサーバーを直接実行することもできます。

実行モード

• 本番モード（Stdio）：

  npm start
  

  • ログは stderr に出力されます（AI アシスタントの起動を模倣します）
  • NODE_ENV=production を使用します

• 開発モード（Stdio、整形済みログ）：

  npm run dev
  

  • ログは整形されて stdout に出力されます
  • nodemon と pino-pretty が必要です
  • NODE_ENV=development を使用します

• SSE モード（HTTP インターフェース）：

  # HTTP 経由の本番モード
  npm run start:sse
  
  # HTTP 経由の開発モード
  npm run dev:sse
  

  • stdio の代わりに HTTP を使用します
  • .env の PORT で設定します（デフォルト：3000）
  • http://localhost:3000 でアクセスできます

詳細なトラブルシューティング

接続の問題

AI アシスタントで MCP サーバーが検出されない

1. 設定パスを確認する：

   • args 配列内の絶対パスが正しいことを確認します
   • Windows でも、すべてのスラッシュが /（順方向のスラッシュ）であることを確認します
   • node <path-to-build/index.js> を直接実行し、Node がファイルを見つけられるかテストします

2. 設定形式を確認する：

   • JSON に構文エラーがなく、有効であることを確認します
   • プロパティ間のカンマが正しいことを確認します
   • mcpServers オブジェクトにサーバーが含まれていることを確認します

3. アシスタントを再起動する：

   • アプリケーションを完全に終了します（最小化するだけではありません）
   • 再度開いて、もう一度試します

サーバーは起動するが、ツールが動作しない

1. 無効化フラグを確認する：

   • "disabled": false が設定されていることを確認します
   • JSON は // コメントをサポートしていないため、// コメントを削除します

2. autoApprove 配列を確認する：

   • autoApprove 配列内のツール名が完全に一致していることを確認します
   • ハイブリッドルーティングを使用している場合は、配列に "process-request" を追加してみます

API キーの問題

1. OpenRouter キーの問題：

   • キーが正しくコピーされていることを再確認します
   • OpenRouter ダッシュボードでキーが有効であることを確認します
   • 十分なクレジットがあるか確認します

2. 環境変数の問題：

   • キーが次の両方で正しいことを確認します：
     • .env ファイル（ローカル実行用）
     • AI アシスタントの設定の env ブロック

パスと権限の問題

1. ビルドディレクトリが見つからない：

   • npm run build を実行し、ビルドディレクトリが存在することを確認します
   • ビルドの出力先が別のディレクトリになっていないか確認します（tsconfig.json を確認してください）

2. ファイル権限エラー：

   • ユーザーに workflow-agent-files ディレクトリへの書き込み権限があることを確認します
   • Unix システムでは、build/index.js に実行権限があるか確認します

ログのデバッグ

1. ローカル実行の場合：

   • コンソール出力でエラーメッセージを確認します
   • .env ファイルで LOG_LEVEL=debug を指定して実行してみます

2. AI アシスタントから実行する場合：

   • env 設定で "NODE_ENV": "production" を設定します
   • アシスタントにログコンソールまたは出力ウィンドウがあるか確認します

ツール固有の問題

1. セマンティックルーティングが動作しない：
   • 初回実行時に埋め込みモデルがダウンロードされる場合があります。ダウンロードメッセージが表示されていないか確認します
   • ツール名を含む、より明確なリクエストを試します

ドキュメント

コアドキュメント

• システム指示：VIBE_CODER_MCP_SYSTEM_INSTRUCTIONS.md - MCP クライアント向けの包括的な使用ガイド
• CI/CD ガイド：CI_CD_GUIDE.md - 効率化されたパイプラインのドキュメント（70％高速化）
• NPM 公開ガイド：NPM_PUBLISHING_GUIDE.md - リリースおよびデプロイのプロセス
• システムアーキテクチャ：docs/ARCHITECTURE.md - Mermaid 図を含む包括的なシステムアーキテクチャ
• パフォーマンスとテスト：docs/PERFORMANCE_AND_TESTING.md - パフォーマンス指標、テスト戦略、品質保証
• Vibe Task Manager：src/tools/vibe-task-manager/README.md - 包括的なタスク管理ドキュメント
• Context Curation Tool：src/tools/curate-context/README.md - 言語に依存しないコードベース分析のドキュメント
• Code Map Tool：src/tools/map-codebase/README.md - 高度なコードベース分析のドキュメント

ツールのドキュメント

• 各ツールの README：各ツールのディレクトリに詳細なドキュメントがあります
• 設定ガイド：環境のセットアップと設定管理
• API リファレンス：ツールのスキーマとパラメーターはシステム指示に記載されています
• 統合例：実践的なワークフローと使用パターン

アーキテクチャのドキュメント

• システムアーキテクチャ：README とシステム指示にある Mermaid 図
• ツールアーキテクチャ：各ツールのアーキテクチャ図
• パフォーマンス指標：現在のステータスと最適化戦略
• 開発ガイドライン：コントリビューションと開発のベストプラクティス

コントリビューション

コントリビューションを歓迎します！コントリビューションガイドラインを確認し、プルリクエストを提出する前にすべてのテストに合格することを確認してください。

開発ワークフロー

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 十分なテストとともに変更を加えます
4. ローカルですべてのチェックに合格することを確認します：

   # Run CI checks (REQUIRED before PR - matches GitHub Actions)
   npm run type-check    # TypeScript validation (must pass)
   npm run lint          # Code quality checks (must pass)
   npm run build         # Build verification (must pass)
   
   # Run tests locally (RECOMMENDED before PR)
   npm run test:unit     # Fast unit tests (~3 minutes)
   
   # Optional: Thorough testing for major changes
   npm run test:integration
   npm test              # All tests
   

5. 詳細な説明を添えてプルリクエストを提出します

品質基準

• 型安全性：any 型は禁止です。厳格な TypeScript が必要です
• CI パイプライン：型チェック、リント、ビルドに合格する必要があります（自動実行）
• テスト：プルリクエストを提出する前に、ローカルでユニットテストを実行してください
• テストカバレッジ：ユニットテストのカバレッジを 70% 超に維持してください
• ドキュメント：変更に応じて関連ドキュメントを更新してください
• パフォーマンス：CI パイプラインの実行速度への影響を考慮してください（目標：5 分未満）

よくあるトラブルシューティング

OpenRouter API キーの問題

問題：ツールで認証エラーが発生します

• 解決方法：OpenRouter API キーが .env に正しく設定されていることを確認してください
• 確認事項：キーに余分なスペースや引用符が含まれていないことを確認してください
• 検証：openrouter.ai でキーをテストしてください
• クレジット：OpenRouter アカウントに十分なクレジットがあることを確認してください

パス設定の問題

問題：「パスが見つかりません」または「アクセスが拒否されました」というエラーが発生します

• 解決方法：すべての設定で、スラッシュ（/）を使用した絶対パスを指定してください
• Windows：C:\Users\name のようなパスを C:/Users/name に変換してください
• 権限：ユーザーが設定済みディレクトリへの読み取り／書き込みアクセス権を持っていることを確認してください
• 環境変数：VIBE_CODER_OUTPUT_DIR と VIBE_PROJECT_ROOT が正しく設定されていることを確認してください（または従来の変数 CODE_MAP_ALLOWED_DIR と VIBE_TASK_MANAGER_READ_DIR）

ビルドの失敗

問題：TypeScript のコンパイルエラーが発生します

• 解決方法：npm run clean && npm run build を実行してください
• 依存関係：node_modules と package-lock.json を削除してから、npm install を実行してください
• Node のバージョン：Node.js v20 以降がインストールされていることを確認してください（node -v）
• TypeScript：npm run lint で構文エラーを確認してください

テストの失敗

問題：ローカルでテストが失敗するか、CI で型チェックエラーが発生します

• 型エラー：問題を早期に検出するため、ローカルで npm run type-check を実行してください
• リントの問題：npm run lint:fix でスタイルの問題を自動修正してください
• 環境：有効な OPENROUTER_API_KEY を含む .env ファイルがあることを確認してください
• メモリ：RAM が 4 GB 未満のシステムでは、テストが失敗することがあります
• ネットワーク：一部のテストにはインターネット接続が必要です
• クリーンアップ：テストを実行する前に npm run clean を実行してください
• CI パイプライン：パイプラインの詳細については、CI/CD ガイドを参照してください

メモリ／パフォーマンスの問題

問題：メモリ使用量が多い、またはパフォーマンスが遅い

• 大規模なコードベース：10,000 ファイルを超えるプロジェクトでは、Code Map Tool が大量のメモリを消費する場合があります
• 解決方法：Node.js のメモリ上限を引き上げてください：NODE_OPTIONS='--max-old-space-size=4096' npm start
• キャッシュ：VibeCoderOutput/ 内のキャッシュディレクトリが大きくなりすぎた場合は、クリアしてください
• モニタリング：npm run test:memory を使ってメモリリークを特定してください

MCP クライアントの接続問題

問題：AI アシスタントがサーバーを検出できない

• パス：MCP 設定内のすべてのパスがスラッシュを使用した絶対パスになっていることを確認してください
• 再起動：AI アシスタントアプリケーションを完全に終了し、再起動してください
• ログ：詳細なエラーメッセージを確認できるよう、設定で LOG_LEVEL=debug を指定してください
• トランスポート："transport": "stdio" が正しく設定されていることを確認してください
• 無効化：設定で "disabled": false になっていることを確認してください

ツール固有の問題

Vibe Task Manager：

• 自然言語のコマンドが機能しない場合は、構造化コマンドを試してください
• プロジェクトファイルが VibeCoderOutput/vibe-task-manager/ にあることを確認してください
• プロジェクト名に特殊文字が含まれていないことを確認してください

Code Map Tool：

• 権限エラーが発生する場合は、CODE_MAP_ALLOWED_DIR が設定されていることを確認してください
• 大規模なリポジトリではタイムアウトすることがあります。小規模なサブディレクトリを試してください
• 言語によっては追加のセットアップが必要です（ツールの README を参照してください）

Context Curator：

• codemap の生成に失敗する場合は、キャッシュ内の最近の codemap を確認してください
• 大規模なコンテキストパッケージ用に十分なディスク容量があることを確認してください
• 対象ディレクトリのファイル権限を確認してください

ネットワークとプロキシの問題

問題：外部サービスに接続できない

• プロキシ：プロキシを使用している場合は、HTTP_PROXY と HTTPS_PROXY 環境変数を設定してください
• SSL：SSL の問題がある場合は、NODE_TLS_REJECT_UNAUTHORIZED=0 を試してください（開発時のみ）
• ファイアウォール：ファイアウォールで HTTPS のアウトバウンド接続が許可されていることを確認してください
• DNS：名前解決に失敗する場合は、パブリック DNS サーバーを試してください

サポートを受ける

問題が解決しない場合：

1. GitHub Issues で既存の問題を確認してください
2. デバッグログを有効にしてください：LOG_LEVEL=debug
3. エラーメッセージとログを収集してください
4. 次の情報を添えて新しい issue を作成してください：
   • Node.js のバージョン（node -v）
   • オペレーティングシステム
   • エラーメッセージ
   • 再現手順

📅 変更履歴

バージョン 0.3.5（最新）

• 強化されたハイブリッドマッチャー：15 個すべてのツールでパラメーター抽出を完全に実装
• CLI／REPL の改善：対話型の確認、進捗状況を表示するジョブのポーリング
• バグ修正：Task-list-generator によるユーザーストーリーの自動生成、複数ターンの会話の問題を修正
• TypeScript 厳格モード：any 型を排除し、本番環境に適したコード品質を実現

バージョン 0.3.1

• グローバルインストールの同期に関する問題を修正
• クリーンビルドプロセスを強化
• NPM パッケージングのワークフローを改善

バージョン 0.2.8

• CLI 対話モードの設定永続化
• プロジェクトルートの検出を強化

バージョン 0.2.7

• npm パッケージに不足していた設定ファイルを追加
• 設定の読み込みエラーを解決

バージョン 0.2.3

• チャットインターフェースを備えた対話型 REPL モード
• 自動検出機能を備えたセットアップウィザードの強化
• 設定テンプレート
• CLI バイナリの統合

すべてのリリース履歴については、GitHub Releases を参照してください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。