Vibe Coder MCP サーバー
Vibe Coderは、AIアシスタント(Cursor、Cline AI、Claude Desktopなど)をソフトウェア開発のための強力なツールで強化するために設計されたMCP(Model Context Protocol)サーバーです。調査、計画、要件定義、スタータープロジェクトの作成など、さまざまな作業に役立ちます。
概要と機能
Vibe Coder MCP は MCP 互換クライアントと統合して、次の機能を提供します。
- セマンティック リクエスト ルーティング: 埋め込みベースのセマンティック マッチングと順次思考フォールバックを使用して、リクエストをインテリジェントにルーティングします。
- ツール レジストリ アーキテクチャ: 自己登録ツールによる集中ツール管理。
- 直接 LLM 呼び出し: ジェネレーター ツールは、信頼性の向上と構造化された出力制御のために直接 LLM 呼び出しを使用するようになりました。
- ワークフロー実行:
workflows.json
で定義されたツール呼び出しの定義済みシーケンスを実行します。 - 調査と計画: 詳細な調査 (
research-manager
) を実行し、PRD (generate-prd
)、ユーザー ストーリー (generate-user-stories
)、タスク リスト (generate-task-list
)、開発ルール (generate-rules
) などの計画ドキュメントを生成します。 - プロジェクト スキャフォールディング: フルスタック スターター キットを生成します (
generate-fullstack-starter-kit
)。 - コード マップ ジェネレーター: コードベースを再帰的にスキャンし、セマンティック情報を抽出して、トークン効率が高くコンテキスト密度の高い、Mermaid ダイアグラム付きの Markdown インデックス、またはインポート用の絶対ファイル パスと拡張クラス プロパティ情報を含む構造化 JSON 表現 (
map-codebase
) を生成します。 - 非同期実行:長時間実行されるツール(ジェネレータ、リサーチ、ワークフローなど)の多くが非同期で実行されるようになりました。これらのツールは即座にジョブIDを返し、最終結果は
get-job-result
ツールを使用して取得されます。 - セッション状態管理: セッション内 (メモリ内) のリクエスト間で基本状態を維持します。
- 標準化されたエラー処理: すべてのツールにわたって一貫したエラー パターン。
(詳細については、以下の「ツールの詳細なドキュメント」および「機能の詳細」セクションを参照してください)
セットアップガイド
Vibe Coder MCP サーバーを実行し、AI アシスタントに接続するには、次のマイクロステップに従います。
ステップ1: 前提条件
- Node.jsのバージョンを確認する:
- ターミナルまたはコマンドプロンプトを開きます。
node -v
を実行する- 出力に v18.0.0 以上が表示されていることを確認します (必須)。
- インストールされていない、または古くなっている場合: nodejs.orgからダウンロードします。
- Git のインストールを確認します。
- ターミナルまたはコマンドプロンプトを開きます。
git --version
を実行する- インストールされていない場合: git-scm.comからダウンロードします。
- OpenRouter APIキーを取得します:
- openrouter.aiにアクセスしてください
- アカウントをお持ちでない場合は作成してください。
- API キーセクションに移動します。
- 新しい API キーを作成してコピーします。
- このキーをステップ 4 で使えるようにしておきます。
ステップ2: コードを取得する
- プロジェクト ディレクトリを作成します(オプション):
- ターミナルまたはコマンドプロンプトを開きます。
- プロジェクトを保存する場所に移動します。
- リポジトリをクローンします。
- 走る:(または、該当する場合はフォークの URL を使用します)
- 走る:
- プロジェクトディレクトリに移動します。
- 走る:
- 走る:
ステップ3: セットアップスクリプトを実行する
ご使用のオペレーティング システムに適したスクリプトを選択してください。
Windowsの場合:
- ターミナル (vibe-coder-mcp ディレクトリ内) で、次を実行します。
- スクリプトが完了するまで待ちます (依存関係がインストールされ、プロジェクトがビルドされ、必要なディレクトリが作成されます)。
- エラー メッセージが表示された場合は、以下のトラブルシューティング セクションを参照してください。
macOS または Linux の場合:
- スクリプトを実行可能にします。
- スクリプトを実行します:
- スクリプトが完了するまで待ちます。
- エラー メッセージが表示された場合は、以下のトラブルシューティング セクションを参照してください。
スクリプトは次のアクションを実行します。
- Node.js のバージョンをチェックします (v18+)
- npm経由ですべての依存関係をインストールします
- 必要な
VibeCoderOutput/
サブディレクトリを作成します (スクリプトでの定義に従って)。 - TypeScript プロジェクトをビルドします。
- **
.env
が存在しない場合は、.env.example
を.env
にコピーします。**このファイルを編集する必要があります。 - 実行権限を設定します (Unix システムの場合)。
ステップ4: 環境変数( .env
)を構成する
セットアップ スクリプト (手順 3) は、 .env
がまだ存在しない場合にのみ、 .env.example
テンプレートをコピーして、プロジェクトのルート ディレクトリに.env
ファイルを自動的に作成します。
- **
.env
を見つけて開く:**メインのvibe-coder-mcp
ディレクトリで.env
ファイルを見つけて、テキスト エディターで開きます。 - OpenRouter APIキーを追加します(必須):
- ファイルには
.env.example
に基づいたテンプレートが含まれています。 - **重要なのは、
"Your OPENROUTER_API_KEY here"
を実際のOpenRouter APIキーに置き換えることです。**キーに引用符が不要な場合は、引用符を削除してください。
- ファイルには
- 出力ディレクトリを構成する(オプション):
- 生成されたファイルの保存場所を変更するには (デフォルトはプロジェクト内の
VibeCoderOutput/
)、次の行を.env
ファイルに追加します。 - パスを任意の絶対パスに置き換えてください。パスにはスラッシュ (
/
) を使用してください。この変数が設定されていない場合は、デフォルトのディレクトリ (VibeCoderOutput/
) が使用されます。
- 生成されたファイルの保存場所を変更するには (デフォルトはプロジェクト内の
- コードマップジェネレーターディレクトリを構成する (オプション):
- コード マップ ジェネレーター ツールがスキャンできるディレクトリを指定するには、次の行を
.env
ファイルに追加します。 - パスを、分析対象のソースコードを含むディレクトリへの絶対パスに置き換えてください。これはセキュリティ境界であり、ツールはこのディレクトリ外のファイルにはアクセスしません。
- セキュリティ上の理由から、
CODE_MAP_ALLOWED_DIR
(ソースコードの読み取り用)とVIBE_CODER_OUTPUT_DIR
(出力ファイルの書き込み用)は別々に設定されていることに注意してください。コードマップ生成ツールは、読み取り操作と書き込み操作に対して別々の検証を行います。
- コード マップ ジェネレーター ツールがスキャンできるディレクトリを指定するには、次の行を
- その他の設定を確認する(オプション):
LOG_LEVEL
(例:LOG_LEVEL=debug
) やNODE_ENV
(例:NODE_ENV=development
) など、サーバーでサポートされている他の環境変数を追加できます。
.env
ファイルを保存します。
ステップ5:AIアシスタントとの統合(MCP設定)
この重要なステップでは、クライアントの MCP 設定ファイルに構成を追加することで、Vibe Coder を AI アシスタントに接続します。
5.1: クライアントのMCP設定ファイルを見つける
場所は AI アシスタントによって異なります。
- Cursor AI / Windsurf / RooCode (VS Code ベース):
- アプリケーションを開きます。
- コマンドパレットを開きます (
Ctrl+Shift+P
またはCmd+Shift+P
)。 - 入力して
Preferences: Open User Settings (JSON)
を選択します。 - これにより、
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
- (注: カーソルの代わりに標準の VS Code を使用する場合は、パス内の
Cursor
をCode
に置き換えてください)
- Windows :
- クロードデスクトップ:
- Windows :
%APPDATA%\Claude\claude_desktop_config.json
- macOS :
~/Library/Application Support/Claude/claude_desktop_config.json
- Linux :
~/.config/Claude/claude_desktop_config.json
- Windows :
5.2: Vibe Coder 設定を追加する
- 上記の設定ファイルをテキスト エディターで開きます。
"mcpServers": { ... }
というJSONオブジェクトを探します。存在しない場合は作成する必要があるかもしれません(ファイル全体が有効なJSONであることを確認してください)。例えば、空のファイルは{"mcpServers": {}}
のように記述される可能性があります。mcpServers
オブジェクトの中括弧{}
**内に、**以下の設定ブロックを追加します。既に他のサーバーがリストされている場合は、このブロックを貼り付ける前に、前のサーバーの閉じ括弧}
の後にカンマ,
を追加してください。- 重要: すべてのプレースホルダーパス(
/path/to/your/vibe-coder-mcp/...
など)を、リポジトリをクローンしたシステム上の正しい絶対パスに置き換えてください。Windowsでもパスにはスラッシュ「/
を使用してください(例:C:/Users/YourName/Projects/vibe-coder-mcp/build/index.js
)。パスの誤りは、サーバーへの接続に失敗する最も一般的な原因です。 - 設定ファイルを保存します。
- 変更を有効にするには、AI アシスタント アプリケーション (Cursor、VS Code、Claude Desktop など)を完全に閉じて再起動します。
ステップ6: 構成をテストする
- AIアシスタントを起動する:
- AI アシスタント アプリケーションを完全に再起動します。
- 簡単なコマンドをテストする:
- 次のようなテストコマンドを入力します:
Research modern JavaScript frameworks
- 次のようなテストコマンドを入力します:
- 適切な応答を確認する:
- 正しく動作している場合は、調査の応答が返されるはずです。
- そうでない場合は、以下のトラブルシューティングのセクションを確認してください。
プロジェクトアーキテクチャ
Vibe Coder MCP サーバーは、ツール レジストリ パターンを中心としたモジュラー アーキテクチャに従います。
ディレクトリ構造
ツールレジストリパターン
ツール レジストリは、ツールの定義と実行を管理するための中心的なコンポーネントです。
連続的な思考プロセス
Sequential Thinking メカニズムは、LLM ベースのフォールバック ルーティングを提供します。
セッション状態管理
ワークフロー実行エンジン
ワークフロー システムでは、複数のステップのシーケンスが可能になります。
ワークフロー構成
ワークフローは、プロジェクトのルートディレクトリにあるworkflows.json
ファイルで定義されます。このファイルには、単一のコマンドで実行できるツール呼び出しのシーケンスが事前に定義されています。
ファイルの場所と構造
workflows.json
ファイルはプロジェクトのルートディレクトリ (package.json と同じレベル) に配置する必要があります。- ファイルは次の構造に従います。
パラメータテンプレート
ワークフロー ステップ パラメータは、以下を参照できるテンプレート文字列をサポートします。
- ワークフロー入力:
{workflow.input.paramName}
- 前のステップの出力:
{steps.stepId.output.content[0].text}
ワークフローのトリガー
run-workflow
ツールを次のように使用します。
詳細なツールドキュメント
src/tools/
ディレクトリ内の各ツールには、それぞれにREADME.mdファイルという包括的なドキュメントが含まれています。これらのファイルの内容は以下のとおりです。
- ツールの概要と目的
- 入出力仕様
- ワークフロー図(マーメイド)
- 使用例
- 使用されるシステムプロンプト
- エラー処理の詳細
詳しい情報については、以下の個別の README を参照してください。
src/tools/fullstack-starter-kit-generator/README.md
src/tools/prd-generator/README.md
src/tools/research-manager/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/code-map-generator/README.md
ツールカテゴリ
分析および情報ツール
- コード マップ ジェネレーター (
map-codebase
) : コードベースをスキャンしてセマンティック情報 (クラス、関数、コメント) を抽出し、Mermaid ダイアグラムを含む人間が判読可能な Markdown マップ、またはインポート用の絶対ファイル パスと拡張クラス プロパティ情報を含む構造化 JSON 表現を生成します。 - リサーチ マネージャー (
research-manager
) : Perplexity Sonar を使用して技術的なトピックに関する詳細な調査を実行し、要約とソースを提供します。
計画およびドキュメントツール
- **ルール ジェネレーター (
generate-rules
):**プロジェクト固有の開発ルールとガイドラインを作成します。 - **PRD ジェネレーター (
generate-prd
):**包括的な製品要件ドキュメントを生成します。 - **ユーザー ストーリー ジェネレーター (
generate-user-stories
):**受け入れ基準を備えた詳細なユーザー ストーリーを作成します。 - **タスク リスト ジェネレーター (
generate-task-list
):**依存関係を持つ構造化された開発タスク リストを構築します。
プロジェクトスキャフォールディングツール
- **フルスタック スターター キット ジェネレーター (
generate-fullstack-starter-kit
):**基本的なセットアップ スクリプトと構成を含む、指定されたフロントエンド/バックエンド テクノロジーを使用してカスタマイズされたプロジェクト スターター キットを作成します。
ワークフローとオーケストレーション
- **ワークフロー ランナー (
run-workflow
):**一般的な開発タスクに対して事前定義された一連のツール呼び出しを実行します。
生成されたファイルの保存
デフォルトでは、ジェネレータツールからの出力は、履歴参照のためにプロジェクト内のVibeCoderOutput/
ディレクトリに保存されます。この場所は、 .env
ファイルまたはAIアシスタント設定でVIBE_CODER_OUTPUT_DIR
環境変数を設定することで上書きできます。
読み取りおよび書き込み操作のセキュリティ境界
セキュリティ上の理由から、Vibe Coder MCP ツールは読み取り操作と書き込み操作に対して個別のセキュリティ境界を維持します。
- 読み取り操作:コードマップジェネレータなどのツールは、
CODE_MAP_ALLOWED_DIR
環境変数で明示的に許可されたディレクトリからのみ読み取ります。これにより明確なセキュリティ境界が設定され、許可されたディレクトリ外のファイルへの不正アクセスを防止します。 - 書き込み操作:すべての出力ファイルは
VIBE_CODER_OUTPUT_DIR
ディレクトリ(またはそのサブディレクトリ)に書き込まれます。この分離により、ツールは指定された出力場所にのみ書き込みを行うため、ソースコードが誤って変更されるのを防ぎます。
構造の例(デフォルトの場所):
使用例
接続された 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"
ローカルで実行(オプション)
主な用途は AI アシスタントとの統合 (stdio を使用) ですが、テストのためにサーバーを直接実行することもできます。
実行モード
- プロダクションモード(Stdio):
- ログは stderr に出力されます (AI アシスタントの起動を模倣します)
- NODE_ENV=production を使用する
- 開発モード (Stdio、Pretty Logs):
- ログはきれいなフォーマットで標準出力に出力されます
nodemon
とpino-pretty
必要です- NODE_ENV=development を使用する
- SSE モード (HTTP インターフェース):
- stdioの代わりにHTTPを使用する
- .env の PORT で設定 (デフォルト: 3000)
- http://localhost:3000にアクセスします
詳細なトラブルシューティング
接続の問題
AIアシスタントでMCPサーバーが検出されない
- 構成パスを確認します:
args
配列の絶対パスが正しいことを確認します- Windowsでもすべてのスラッシュがスラッシュ
/
であることを確認してください - Node がそれを見つけられるかどうかをテストするには、直接
node <path-to-build/index.js>
を実行します。
- 構成形式を確認してください:
- JSONが構文エラーなしで有効であることを確認する
- プロパティ間のカンマが正しいことを確認してください
mcpServers
オブジェクトにサーバーが含まれていることを確認します
- アシスタントを再起動します。
- アプリケーションを完全に閉じる(最小化ではなく)
- もう一度開いてお試しください
サーバーは起動するがツールが動作しない
- 無効フラグをチェック:
"disabled": false
に設定されていることを確認する- JSONは
//
コメントをサポートしていないため、削除してください。
- autoApprove配列を検証します:
autoApprove
配列内のツール名が完全に一致していることを確認します- ハイブリッドルーティングを使用している場合は、配列に
"process-request"
を追加してみてください。
APIキーの問題
- OpenRouter の主な問題:
- キーが正しくコピーされたことを再確認する
- OpenRouterダッシュボードでキーがアクティブであることを確認します
- 十分なクレジットがあるか確認してください
- 環境変数の問題:
- 両方でキーが正しいことを確認します。
.env
ファイル (ローカル実行用)- AIアシスタントの設定envブロック
- 両方でキーが正しいことを確認します。
パスと権限の問題
- ビルドディレクトリが見つかりません:
npm run build
実行してビルドディレクトリが存在することを確認します。- ビルド出力が別のディレクトリに送られるかどうかを確認します(tsconfig.json を確認します)
- ファイル権限エラー:
- ユーザーが workflow-agent-files ディレクトリへの書き込み権限を持っていることを確認します。
- Unixシステムでは、build/index.jsに実行権限があるか確認する
ログデバッグ
- ローカル実行の場合:
- コンソール出力でエラーメッセージを確認します
.env
ファイルでLOG_LEVEL=debug
指定して実行してみてください
- AIアシスタント実行の場合:
- env設定で
"NODE_ENV": "production"
に設定する - アシスタントにログコンソールまたは出力ウィンドウがあるかどうかを確認します
- env設定で
ツール固有の問題
- セマンティックルーティングが機能しない:
- 最初の実行では埋め込みモデルがダウンロードされる可能性があります - ダウンロードメッセージを確認してください
- ツール名を明記したより明確なリクエストを試してください
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
ソフトウェア開発用の強力なツールで AI アシスタントを強化し、自然言語によるインタラクションを通じてリサーチ、計画、コード生成、プロジェクトのスキャフォールディングを可能にする MCP サーバーです。
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.Last updated -32805TypeScriptMIT License
- -securityAlicense-qualityAn MCP server that analyzes codebases and generates contextual prompts, making it easier for AI assistants to understand and work with code repositories.Last updated -10PythonMIT License
- AsecurityAlicenseAqualityA MCP server that enables human-in-the-loop workflow in AI-assisted development tools by allowing users to run commands, view their output, and provide textual feedback directly to the AI assistant.Last updated -1453PythonMIT License
- AsecurityAlicenseAqualityA powerful MCP server that provides interactive user feedback and command execution capabilities for AI-assisted development, featuring a graphical interface with text and image support.Last updated -119PythonMIT License