Vibe-Coder MCP Server

Vibe-Coder MCP Server

一个 Model Context Protocol 服务，为基于大模型的编码实现结构化开发工作流。

概述

此 MCP 服务通过提供以下功能，帮助大模型以有条理、清晰且安全的方式构建功能：

• 通过引导式提问进行结构化的功能需求澄清
• 生成 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. 完成：验证所有需求均已实现，且功能已可供使用