Vibe-Coder MCP 服务器

实现基于 LLM 编码的结构化开发工作流程的模型上下文协议服务器。

概述

该 MCP 服务器通过提供以下功能帮助 LLM 以有组织、干净、安全的方式构建功能：

• 带有引导性问题的结构化功能澄清流程

• PRD 和实施计划生成

• 通过任务跟踪进行分阶段开发

• 进度跟踪和状态报告

• 文档存储和检索功能

Related MCP server: DevFlow MCP Server

特征

资源

• 功能详情、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

检查器将提供一个 URL 来访问浏览器中的调试工具。

实施说明

该服务器使用模型上下文协议 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. 完成：验证所有要求均已实现且该功能已可供使用