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 도구를 사용하면 문서를 사용자 정의 위치에 저장할 수 있습니다.

지엑스피1

경로 검색

문서 경로를 얻으려면 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을 제공합니다.

구현 노트

이 서버는 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. 완료 : 모든 요구 사항이 구현되었고 기능을 사용할 준비가 되었는지 확인합니다.