MCP 服务器

Vibe-Coder MCP Server

一个 MCP 服务器，它为基于 LLM 的编码实现结构化的工作流程，通过功能澄清、文档生成、分阶段实施和进度跟踪来指导开发。

README

Vibe-Coder 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 - 用于规划功能开发的提示模板

文档存储

该服务器包含一个混合文档存储系统，该系统：

自动将生成的文档（PRD、实施计划）保存到文件
维护内存中的副本以进行快速访问
允许客户端检索文档路径并保存到自定义位置

默认存储位置

文档默认存储在 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";

// 创建一个 MCP 服务器
const server = new McpServer({
  name: "Vibe-Coder",
  version: "0.3.0"
});

// 添加一个资源
server.resource(
  "features-list",
  "features://list",
  async (uri) => ({ /* ... */ })
);

// 添加一个工具
server.tool(
  "start_feature_clarification",
  { /* parameters schema */ },
  async (params) => ({ /* ... */ })
);

// 添加一个提示
server.prompt(
  "feature-planning",
  { /* parameters schema */ },
  (params) => ({ /* ... */ })
);

// 启动服务器
const transport = new StdioServerTransport();
await server.connect(transport);