Vibecodermcp

🚀 Vibe-Coder MCP 服務器

Vibe-Coder MCP 服務器是一個用於基於大語言模型（LLM）進行編碼的工具，它實現了結構化開發流程，能助力 LLM 高效完成特性構建。

🚀 快速開始

此 MCP 服務器通過提供以下功能幫助 LLM 進行特性構建：

• 結構化的功能澄清過程，帶有引導性問題
• 產品需求文檔 (PRD) 和實現計劃生成
• 分階段開發，任務跟蹤
• 開發進度和狀態報告跟蹤
• 文檔存儲和檢索能力

✨ 主要特性

資源

• 特性詳細信息、PRDs 和實現計劃
• 進度報告和狀態跟蹤
• 階段和任務詳細信息

工具

• 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 服務器通過標準輸入/輸出進行通信，調試可能會具有挑戰性。我們推薦使用 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",