local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides Git integration through the git-summary tool to display current Git changes and status, helping with code commit preparation
Supports creation of Mermaid diagrams in documentation, used throughout planning tools for visualizing workflows and architecture
Offers Node.js project analysis including dependency examination and project scaffolding capabilities
Vibe Coder MCP サーバー
Vibe Coderは、AIアシスタント(Cursor、Cline AI、Claude Desktopなど)をソフトウェア開発のための強力なツールで強化するために設計されたMCP(Model Context Protocol)サーバーです。調査、計画、要件定義、スタータープロジェクトの作成など、さまざまな作業に役立ちます。
概要と機能
Vibe Coder MCP は MCP 互換クライアントと統合して、次の機能を提供します。
- セマンティック リクエスト ルーティング: 埋め込みベースのセマンティック マッチングと順次思考フォールバックを使用して、リクエストをインテリジェントにルーティングします。
- ツール レジストリ アーキテクチャ: 自己登録ツールによる集中ツール管理。
- 直接 LLM 呼び出し: ジェネレーター ツールは、信頼性の向上と構造化された出力制御のために直接 LLM 呼び出しを使用するようになりました。
- ワークフロー実行:
workflows.json
で定義されたツール呼び出しの定義済みシーケンスを実行します。 - コード生成: コード スタブとボイラープレートを作成します (
generate-code-stub
)。 - コード リファクタリング: 既存のコード スニペットを改善および変更します (
refactor-code
)。 - 依存関係分析: マニフェスト ファイルから依存関係を一覧表示します (
analyze-dependencies
)。 - Git 統合: 現在の Git の変更を要約します (
git-summary
)。 - 調査と計画: 詳細な調査 (
research-manager
) を実行し、PRD (generate-prd
)、ユーザー ストーリー (generate-user-stories
)、タスク リスト (generate-task-list
)、開発ルール (generate-rules
) などの計画ドキュメントを生成します。 - プロジェクト スキャフォールディング: フルスタック スターター キットを生成します (
generate-fullstack-starter-kit
)。 - 非同期実行:長時間実行されるツール(ジェネレータ、リサーチ、ワークフローなど)の多くが非同期で実行されるようになりました。これらのツールは即座にジョブ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: コードを取得する
- プロジェクト ディレクトリを作成します(オプション):
- ターミナルまたはコマンドプロンプトを開きます。
- プロジェクトを保存する場所に移動します。Copy
- リポジトリをクローンします。
- 走る:(または、該当する場合はフォークの URL を使用します)Copy
- 走る:
- プロジェクトディレクトリに移動します。
- 走る:Copy
- 走る:
ステップ3: セットアップスクリプトを実行する
ご使用のオペレーティング システムに適したスクリプトを選択してください。
Windowsの場合:
- ターミナル (vibe-coder-mcp ディレクトリ内) で、次を実行します。Copy
- スクリプトが完了するまで待ちます (依存関係がインストールされ、プロジェクトがビルドされ、必要なディレクトリが作成されます)。
- エラー メッセージが表示された場合は、以下のトラブルシューティング セクションを参照してください。
macOS または Linux の場合:
- スクリプトを実行可能にします。Copy
- スクリプトを実行します:Copy
- スクリプトが完了するまで待ちます。
- エラー メッセージが表示された場合は、以下のトラブルシューティング セクションを参照してください。
スクリプトは次のアクションを実行します。
- Node.js のバージョンをチェックします (v18+)
- npm経由ですべての依存関係をインストールします
- 必要なワークフローエージェントファイルディレクトリを作成します
- TypeScriptプロジェクトをビルドする
- デフォルトの
.env
ファイルが存在しない場合は作成します (次にこれを入力します)。 - 実行権限を設定します(Unix システムの場合)
ステップ4: 環境変数を設定する ( .env
)
.env
ファイルを見つけます。- メインの
vibe-coder-mcp
ディレクトリで、セットアップ スクリプトによって作成された.env
ファイルを見つけます。 - 任意のテキストエディタで開きます。
- メインの
- OpenRouter APIキーを追加します:
- 次の行を見つけます:
OPENROUTER_API_KEY=your_openrouter_api_key_here
your_openrouter_api_key_here
実際の OpenRouter API キーに置き換えます。- キーの前後に引用符を追加しないでください。
- 次の行を見つけます:
- 出力ディレクトリを構成する(オプション):
- 生成されたファイルの保存場所を変更するには (デフォルトはプロジェクト内の
workflow-agent-files/
)、次の行を追加します。Copy - パスを任意の絶対パスに置き換えてください。スラッシュ(
/
)を使用してください。この変数が設定されていない場合は、デフォルトのディレクトリが使用されます。
- 生成されたファイルの保存場所を変更するには (デフォルトはプロジェクト内の
- その他の設定を確認する(オプション):
- モデル名(
GEMINI_MODEL
、PERPLEXITY_MODEL
)を確認し、OpenRouterプランで利用可能かどうかを確認してください。必要に応じて、llm_config.json
ファイルでタスクごとにより詳細な制御を行うことができます。 LOG_LEVEL
を確認します (デフォルト: info) - オプションには、「fatal」、「error」、「warn」、「info」、「debug」、「trace」が含まれます。
- モデル名(
.env
ファイルを保存します。
ステップ5:AIアシスタントとの統合
この重要なステップにより、Vibe Coder が AI アシスタントに接続されます。環境ごとに若干異なる設定が必要です。
5.1: プロジェクトの絶対パスを見つける
build/index.js
ファイルへの完全な絶対パスが必要です。
Windowsの場合:
- ターミナルで、ビルド ディレクトリに移動します。Copy
- 絶対パスを取得します:Copy
- 出力をコピーします(例:
C:\Users\YourName\Projects\vibe-coder-mcp\build\index.js
)
macOS/Linuxの場合:
- ターミナルで、ビルド ディレクトリに移動します。Copy
- 絶対パスを取得します:Copy
- 出力に
/index.js
を追加し、結果をコピーします (例:/Users/YourName/Projects/vibe-coder-mcp/build/index.js
)
5.2: 構成ブロックの準備
次の方法で構成ブロックを作成します。
- 次の JSON テンプレートをコピーします。Copy
PATH_PLACEHOLDER
、手順 5.1 で取得した絶対パスに置き換えます。- 重要: Windows でもスラッシュ
/
使用してください (例:C:/Users/...
)
- 重要: Windows でもスラッシュ
- 重要:
OPENROUTER_API_KEY
をこの設定ブロックに直接記述しないでください.env
ファイル内にのみ記述してください。
5.3: 特定のAIアシスタントを構成する
A. カーソルAI / Windsurf(VSコードベース)
- カーソルまたは Windsurf アプリケーションを開きます。
- コマンドパレットを開く:
- Windows/Linux:
Ctrl+Shift+P
を押します - macOS:
Cmd+Shift+P
を押す
- Windows/Linux:
- 入力して選択:
Preferences: Open User Settings (JSON)
- JSON ファイルで、
mcpServers
オブジェクトを見つけるか追加します。- 存在しない場合は追加します:
"mcpServers": {}
- 存在する場合は、このオブジェクトの閉じ括弧を見つけます
- 存在しない場合は追加します:
mcpServers
オブジェクト内に構成ブロックを追加します。- 他のサーバーがリストされている場合は、最後のサーバーの後にカンマを追加します。
- 手順5.2の設定ブロックを貼り付けます
- ファイルを保存します(
Ctrl+S
またはCmd+S
) - カーソル/ウィンドサーフィンを完全に閉じて再起動します
完全なsettings.jsonセクションの例:
B. Cline AI(VS Code拡張機能)
- Cline 設定ファイルを見つけます。
- Windows :
C:\Users\[YourUsername]\AppData\Roaming\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
- Windows :
- このファイルをテキストエディタで開きます。
mcpServers
オブジェクトを検索または追加します。- ファイルが空の場合は、次を追加します:
{"mcpServers": {}}
- 存在するが
mcpServers
がない場合は、ルートレベルに追加します。
- ファイルが空の場合は、次を追加します:
mcpServers
オブジェクト内に構成ブロックを追加します。- 他のサーバーがリストされている場合は、最後のサーバーの後にカンマを追加します。
- 手順5.2の設定ブロックを貼り付けます
- ファイルを保存します。
- VS Code を完全に再起動します。
C. RooCode(VS Codeフォーク)
- RooCode を開きます。
- コマンドパレットを開きます (
Ctrl+Shift+P
またはCmd+Shift+P
)。 Preferences: Open User Settings (JSON)
を検索して選択します。- Cursor AI (上記のセクション A) と同じ手順に従います。
- RooCode を保存して再起動します。
D. クロード デスクトップ
- Claude デスクトップ設定ファイルを見つけます。
- Windows :
C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json
- macOS :
~/Library/Application Support/Claude/claude_desktop_config.json
- Linux :
~/.config/Claude/claude_desktop_config.json
- Windows :
- このファイルをテキストエディタで開きます。
- ルート レベルで
mcpServers
オブジェクトを見つけるか追加します。- ファイルに他のコンテンツがある場合は、
mcpServers
を追加する場所を見つけます - すでに
mcpServers
がある場合はそれを見つけます
- ファイルに他のコンテンツがある場合は、
mcpServers
オブジェクト内に構成ブロックを追加します。- 他のサーバーが存在する場合は、最後のサーバーの後にカンマを追加してください。
- 手順5.2の設定ブロックを貼り付けます
- ファイルを保存します。
- Claude Desktop を閉じて再度開きます。
完全な claude_desktop_config.json の例:
ステップ6: 構成をテストする
- AIアシスタントを起動する:
- AI アシスタント アプリケーションを完全に再起動します。
- 簡単なコマンドをテストする:
- 次のようなテストコマンドを入力します:
Research modern JavaScript frameworks
- 次のようなテストコマンドを入力します:
- 適切な応答を確認する:
- 正しく動作している場合は、調査の応答が返されるはずです。
- そうでない場合は、以下のトラブルシューティングのセクションを確認してください。
プロジェクトアーキテクチャ
Vibe Coder MCP サーバーは、ツール レジストリ パターンを中心としたモジュラー アーキテクチャに従います。
ディレクトリ構造
セマンティックルーティングシステム
Vibe Coder は、洗練されたルーティング アプローチを使用して、各リクエストに適したツールを選択します。
ツールレジストリパターン
ツール レジストリは、ツールの定義と実行を管理するための中心的なコンポーネントです。
連続的な思考プロセス
Sequential Thinking メカニズムは、LLM ベースのフォールバック ルーティングを提供します。
セッション状態管理
ワークフロー実行エンジン
ワークフロー システムでは、複数のステップのシーケンスが可能になります。
ワークフロー構成
ワークフローは、プロジェクトのルートディレクトリにあるworkflows.json
ファイルで定義されます。このファイルには、単一のコマンドで実行できるツール呼び出しのシーケンスが事前に定義されています。
ファイルの場所と構造
workflows.json
ファイルはプロジェクトのルートディレクトリ (package.json と同じレベル) に配置する必要があります。- ファイルは次の構造に従います。Copy
パラメータテンプレート
ワークフロー ステップ パラメータは、以下を参照できるテンプレート文字列をサポートします。
- ワークフロー入力:
{workflow.input.paramName}
- 前のステップの出力:
{steps.stepId.output.content[0].text}
ワークフローのトリガー
run-workflow
ツールを次のように使用します。
詳細なツールドキュメント
src/tools/
ディレクトリ内の各ツールには、それぞれにREADME.mdファイルという包括的なドキュメントが含まれています。これらのファイルの内容は以下のとおりです。
- ツールの概要と目的
- 入出力仕様
- ワークフロー図(マーメイド)
- 使用例
- 使用されるシステムプロンプト
- エラー処理の詳細
詳しい情報については、以下の個別の README を参照してください。
src/tools/code-refactor-generator/README.md
src/tools/code-stub-generator/README.md
src/tools/dependency-analyzer/README.md
src/tools/fullstack-starter-kit-generator/README.md
src/tools/git-summary-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
ツールカテゴリ
コード生成とリファクタリングツール
- コードスタブジェネレーター (
generate-code-stub
) : 記述と対象言語に基づいて、定型コード(関数、クラスなど)を作成します。新しいコンポーネントを素早く構築するのに役立ちます。 - コード リファクタリング ジェネレーター (
refactor-code
) : 既存のコード スニペットとリファクタリング指示 (「async/await に変換する」、「読みやすさを向上させる」、「エラー処理を追加する」など) を受け取り、変更されたコードを返します。
分析および情報ツール
- 依存関係アナライザー (
analyze-dependencies
) :package.json
やrequirements.txt
などのマニフェスト ファイルを解析して、プロジェクトの依存関係を一覧表示します。 - Git サマリージェネレータ (
git-summary
) : 現在の Git ステータスの概要を提供し、ステージング済みまたは未ステージングの変更 (diff) を表示します。コミット前の簡単な確認に便利です。 - リサーチ マネージャー (
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
環境変数を設定することで上書きできます。
構造の例(デフォルトの場所):
使用例
接続された 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
- コードスタブの生成:
Generate a python function stub named 'calculate_discount' that takes price and percentage
- コードのリファクタリング:
Refactor this code to use async/await: [paste code snippet]
- 依存関係の分析:
Analyze dependencies in package.json
- Git サマリー:
Show unstaged git changes
- ワークフローの実行:
Run workflow newProjectSetup with input { "projectName": "my-new-app", "description": "A simple task manager" }
ローカルで実行(オプション)
主な用途は AI アシスタントとの統合 (stdio を使用) ですが、テストのためにサーバーを直接実行することもできます。
実行モード
- プロダクションモード(Stdio):Copy
- ログは stderr に送信されます (AI アシスタントの起動を模倣します)
- NODE_ENV=production を使用する
- 開発モード (Stdio、Pretty Logs):Copy
- ログはきれいなフォーマットで標準出力に出力されます
nodemon
とpino-pretty
必要です- NODE_ENV=development を使用する
- SSE モード (HTTP インターフェース):Copy
- 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設定で
ツール固有の問題
- セマンティックルーティングが機能しない:
- 最初の実行では埋め込みモデルがダウンロードされる可能性があります - ダウンロードメッセージを確認してください
- ツール名を明記したより明確なリクエストを試してください
- **Git サマリーツール
You must be authenticated.
Tools
ソフトウェア開発用の強力なツールで AI アシスタントを強化し、自然言語によるインタラクションを通じてリサーチ、計画、コード生成、プロジェクトのスキャフォールディングを可能にする MCP サーバーです。
- Overview & Features
- Setup Guide
- Project Architecture
- Directory Structure
- Semantic Routing System
- Tool Registry Pattern
- Sequential Thinking Process
- Session State Management
- Workflow Execution Engine
- Workflow Configuration
- Detailed Tool Documentation
- Tool Categories
- Generated File Storage
- Usage Examples
- Running Locally (Optional)
- Detailed Troubleshooting