LLM编程开发流程管理服务器

一个为基于LLM的编程提供结构化开发流程的协议服务器,包含需求澄清、文档生成、阶段化开发和进度跟踪功能。

  • by crazyrabbitLTC
  • TypeScript
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 crazyrabbitLTC/mcp-vibecoder

使用说明

Vibe编码器MCP服务器

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

概述

此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检查员,可作为包脚本使用:

npm run inspector

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

实现注意事项

此服务器使用高级 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. 完成:验证所有要求均已实现,功能已准备好使用