MCP Vibecoder

🚀 Vibe-Coder MCP サーバー

LLM ベースのコーディングにおいて、構造化された開発ワークフローを実現するモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

この MCP サーバーは、LLM が機能を構築するのを支援するために、以下の機能を提供します。

✨ 主な機能

リソース

• 機能の詳細情報、PRD、および実装計画
• 進捗報告と状態追跡
• フェーズとタスクの詳細情報

ツール

• start_feature_clarification - 機能の明確化プロセスを開始します。
• provide_clarification - 機能に関する明確化の質問に回答します。
• generate_prd - 製品要件文書（PRD）と実装計画を生成します。
• create_phase - 機能の開発フェーズを作成します。
• add_task - 開発フェーズにタスクを追加します。
• update_phase_status - フェーズの状態を更新します。
• update_task_status - タスクの完了状態を更新します。
• get_next_phase_action - 次のアクションのガイダンスを取得します。
• get_document_path - 生成されたドキュメントのパスを取得します。
• save_document - ドキュメントを特定の場所に保存します。

プロンプト

• feature-planning - 機能開発の計画を立てるためのプロンプトテンプレートです。

📚 ドキュメント

ドキュメントの保存

このサーバーは、ハイブリッド型のドキュメント保存システムを備えており、以下の機能を有しています。

1. 生成されたドキュメント（PRD、実装計画）を自動的にファイルに保存します。
2. メモリ内にコピーを保持して、高速アクセスを可能にします。
3. クライアントがドキュメントのパスを取得し、カスタム場所に保存できるようにします。

デフォルトの保存場所

ドキュメントは、デフォルトで documents/{featureId}/ ディレクトリに保存されます。ファイル名はドキュメントの種類に基づいています。

• documents/{featureId}/prd.md - 製品要件文書
• documents/{featureId}/implementation-plan.md - 実装計画

カスタム保存

save_document ツールを使用して、ドキュメントをカスタム場所に保存できます。

{
  "featureId": "feature-123",
  "documentType": "prd",
  "filePath": "/custom/path/feature-123-prd.md"
}

パスの取得

ドキュメントのパスを取得するには、get_document_path ツールを使用します。

{
  "featureId": "feature-123",
  "documentType": "prd"
}

これにより、パスとドキュメントがディスクに保存されているかどうかが返されます。

📦 インストール

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再構築を使用して開発します。

npm run watch

インストール手順

互換性のある MCP クライアントと一緒に使用します。

MacOS では：~/Library/Application Support/Claude/claude_desktop_config.json Windows では：%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "/path/to/vibe-coder-mcp/build/mcp-server.js"
    }
  }
}

デバッグ

MCP サーバーは標準入出力を介して通信するため、デバッグは困難な場合があります。MCP Inspector をおすすめします。これはパッケージスクリプトとして提供されています。

npm run inspector

Inspector は、デバッグツールにアクセスするための URL を提供し、ブラウザで開くことができます。

🔧 技術詳細

このサーバーは、Model Context Protocol TypeScript SDK の高度な McpServer クラスを使用して実装されています。これにより、MCP サーバーの作成が簡素化され、リソース、ツール、およびプロンプトを定義するためのクリーンな API が提供されます。

import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// MCP サーバーを作成します。
const server = new McpServer({
  name: "Vibe-Coder",
  version: "0.3.0"
});

// リソースを追加します。
server.resource(
  "features-list",
  "features://list",
  (request) => {
    // リクエストを処理するロジック
  }
);

// ツールを追加します。
server.tool(
  "generate_prd",
  (request) => {
    // PRD を生成するロジック
  }
);

// プロンプトを追加します。
server.prompt(
  "feature-planning",
  (request) => {
    // プロンプトを処理するロジック
  }
);

以上の手順を実行することで、LLM ベースのコーディング開発を支援する機能豊富な MCP サーバーをセットアップすることができます。