Vibe-Coder MCP Server

Vibe-Coder MCP Server

LLM ベースのコーディング向けに、構造化された開発ワークフローを実装する Model Context Protocol サーバーです。

概要

この MCP サーバーは、以下を提供することで、LLM が整理され、クリーンで安全な方法で機能を構築できるよう支援します。

• ガイド付き質問による、構造化された機能の明確化プロセス
• PRD と実装計画の生成
• タスク追跡を伴う段階的な開発
• 進捗の追跡とステータスの報告
• ドキュメントの保存と取得機能

機能

リソース

• 機能の詳細、PRD、実装計画
• 進捗レポートとステータスの追跡
• フェーズとタスクの詳細

ツール

• start_feature_clarification - 機能の明確化プロセスを開始します
• provide_clarification - 機能に関する明確化の質問に回答します
• generate_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 サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

実装に関する注意事項

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

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

// Create an MCP server
const server = new McpServer({
  name: "Vibe-Coder",
  version: "0.3.0"
});

// Add a resource
server.resource(
  "features-list",
  "features://list",
  async (uri) => ({ /* ... */ })
);

// Add a tool
server.tool(
  "start_feature_clarification",
  { /* parameters schema */ },
  async (params) => ({ /* ... */ })
);

// Add a prompt
server.prompt(
  "feature-planning",
  { /* parameters schema */ },
  (params) => ({ /* ... */ })
);

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

ワークフロー

Vibe-Coder MCP サーバーは、次の手順を通じて開発プロセスをガイドするよう設計されています。

1. 機能の明確化：要件を収集し、機能の目的、対象ユーザー、制約を把握することから始めます
2. ドキュメント作成：明確化した要件に基づいて、PRD と実装計画を生成します
3. 段階的な開発：実装を、明確なタスクを含む論理的なフェーズに分割します
4. 進捗の追跡：タスクとフェーズの完了状況を監視し、開発をガイドします
5. 完了：すべての要件が実装され、機能を使用できる状態になっていることを確認します