MCP Vibecoder

🚀 Vibe - Coder MCP 服務器

Vibe - Coder MCP 服務器是一個用於基於大語言模型（LLM）編碼的模型上下文協議（MCP）服務器，它實現了結構化的開發工作流程，能有效輔助 LLM 構建特性。

🚀 快速開始

Vibe - Coder MCP 服務器可幫助 LLM 構建特性，具備結構化的特性澄清過程、生成產品需求文檔和實現計劃、分階段開發與任務跟蹤、進度跟蹤和狀態報告以及文檔存儲和檢索等功能。使用時，需與兼容的 MCP 客戶端配合，按以下步驟操作：

1. 安裝依賴：

npm install

2. 構建服務器：

npm run build

3. 若需使用自動重建進行開發：

npm run watch

4. 配置客戶端：
   • 在 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 服務器通過提供以下功能幫助 LLM 構建特性：

• 結構化的特性澄清過程，帶有引導式問題
• 生成產品需求文檔 (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"
    }
  }
}

💻 使用示例

基礎用法

資源使用

該服務器提供的資源包括特性詳細信息、PRDs 和實現計劃、進度報告和狀態跟蹤、階段和任務詳細信息。

工具調用

以下是部分工具的調用示例：

// 開始特性澄清過程
server.tool(
  "start_feature_clarification",
  (request) => {
    // 開始特性澄清的邏輯
  }
);
// 回答關於特性的澄清問題
server.tool(
  "provide_clarification",
  (request) => {
    // 回答澄清問題的邏輯
  }
);

高級用法

文檔存儲與檢索

該服務器包含一個混合式文檔存儲系統，以下是相關操作示例：

默認存儲

文檔默認存儲在 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"
}

📚 詳細文檔

資源

工具

提示

🔧 技術細節

該服務器使用 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) => {
    // 處理提示的邏輯
  }
);

通過以上步驟，您可以設置一個功能齊全的 MCP 服務器來輔助基於 LLM 的編碼開發。

💡 使用建議 由於 MCP 服務器通過標準輸入輸出進行通信，調試可能會比較困難。推薦使用 MCP Inspector，它作為一個包腳本提供：

npm run inspector

Inspector 將提供一個訪問調試工具的 URL，在您的瀏覽器中打開。