hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides templates for designing GitHub workflow plans including branch strategies, PR templates, and CI/CD configurations
Supports generating API architecture plans with MongoDB integration as a database option
Supports generating API architecture plans with MySQL integration as a database option

TypeScript 프롬프트 MCP 서버

AI 어시스턴트를 위한 사전 정의된 프롬프트 템플릿을 제공하는 MCP(Model Context Protocol) 서버로, 이를 통해 AI 어시스턴트가 TypeScript 프로젝트, API 아키텍처, GitHub 워크플로에 대한 포괄적인 계획을 생성할 수 있습니다.

🌟 개요

이 MCP 서버는 AI 어시스턴트가 TypeScript 프로젝트 계획을 위한 상세하고 체계적인 응답을 생성하는 데 사용할 수 있는 프롬프트 템플릿 세트를 제공합니다. 다음과 같은 템플릿을 제공합니다.

포괄적인 API 아키텍처 계획 작성
모범 사례를 사용하여 새로운 TypeScript 프로젝트 설정
GitHub 워크플로 구성 생성

이 MCP는 로컬 개발 MCP와 함께 작동하도록 특별히 제작되었으며, 프롬프트 MCP가 세부적인 프로젝트 계획을 생성하고 로컬 개발 MCP가 이를 실행하는 강력한 조합을 형성합니다. 이 두 가지가 함께 AI 지원 TypeScript 프로젝트 개발을 위한 원활한 워크플로를 구축합니다.

각 프롬프트 템플릿은 AI 어시스턴트가 최신 TypeScript 개발 표준을 따라 일관되고 고품질이며 상세한 프로젝트 계획을 제공할 수 있도록 설계되었습니다.

🚀 특징

🏗️ API 아키텍처 계획 : 계층, 폴더 구조, 데이터베이스 스키마를 포함한 포괄적인 API 아키텍처 계획을 생성합니다.
🚀 프로젝트 설정 : 적절한 종속성 및 구성을 사용하여 새로운 TypeScript 프로젝트에 대한 자세한 설정 계획을 작성합니다.
🔄 GitHub 워크플로 : 브랜치 전략, PR 템플릿, CI/CD 구성을 사용하여 GitHub 워크플로 계획을 설계합니다.
🛠️ 사용자 정의 : 각 프롬프트는 생성된 계획을 특정 요구 사항에 맞게 조정하기 위한 매개변수를 허용합니다.
⚡ 일관된 출력 : AI 어시스턴트가 모범 사례를 따르는 체계적이고 자세한 응답을 제공하도록 보장합니다.

📋 필수 조건

Node.js(v14 이상)
npm 또는 yarn

🔧 설치

저장소를 복제합니다지엑스피1
종속성 설치
npm install
환경 변수 설정
# Create development environment file cp .env.example .env.development # Create production environment file cp .env.example .env.production

🎮 사용법

개발 모드

npm run dev

이렇게 하면 MCP 서버가 핫 리로드를 사용하여 개발 모드로 시작됩니다.

생산 모드

npm run build
npm start

또는 다음과 같은 약어를 사용하세요.

npm run prod

🔗 로컬 Dev MCP 및 Claude Desktop과의 통합

Claude Desktop에 이 MCP 서버를 추가하려면:

MCP 서버를 시작합니다. 서버가 로컬에서 실행 중인지 확인하세요.
Claude Desktop 설정 열기
- Claude Desktop 실행
- 오른쪽 상단의 프로필 사진이나 아이콘을 클릭하세요
- 드롭다운 메뉴에서 "설정"을 선택하세요
확장 프로그램 설정으로 이동
- 설정 사이드바에서 "확장 프로그램"을 클릭하세요.
- "사용자 정의 MCP 추가"를 선택하세요

4.1 MCP 연결 구성

이름: TypeScript Prompt MCP (또는 원하는 이름)
URL: MCP 서버가 실행되는 URL을 입력하세요(예: 로컬 개발의 경우 http://localhost:3000 )
"MCP 추가"를 클릭하세요

4.2 대안: 명령을 통해 MCP 연결 구성

먼저 프로젝트를 빌드하고 컴파일된 서버에 대한 전체 경로를 제공해야 합니다.
Claude Desktop 구성에 다음을 추가하세요.

"ts-prompts": {
  "command": "node",
  "args": [
    "YOUR_CUSTOM_PATH/dist/index.js"
  ]
}

MCP 활성화
- 새로 추가한 MCP 옆에 있는 스위치를 토글하여 활성화합니다.
- Claude Desktop은 MCP 서버에 연결을 시도합니다.
로컬 Dev MCP 추가
- Claude Desktop에 Local Dev MCP를 추가하려면 3-5단계를 반복합니다.
- 두 MCP를 모두 활성화하면 계획부터 구현까지 완전한 워크플로가 가능합니다.
연결 확인
- Claude와 새로운 대화를 시작하세요
- Claude에게 TypeScript 프로젝트나 API 아키텍처를 계획하는 데 도움을 요청하세요.
- 이제 Claude는 프롬프트 템플릿을 사용하여 자세한 계획을 제공할 수 있어야 합니다.
- 그런 다음 Claude에게 Local Dev MCP를 사용하여 계획을 구현하도록 요청합니다.

Claude를 사용한 사용 예

두 MCP에 모두 연결되면 Claude에게 다음을 요청할 수 있습니다.

"MongoDB와 JWT 인증을 사용하는 'ecommerce-backend'라는 TypeScript 프로젝트에 대한 API 아키텍처를 계획하는 데 도움을 주실 수 있나요?" (이 프롬프트 MCP 사용)
"React 구성 요소를 포함하는 새로운 TypeScript 프런트엔드 라이브러리에 대한 설정 계획이 필요합니다"(이 Prompt MCP 사용)
"자동 테스트 및 npm 게시를 통해 TypeScript CLI 프로젝트에 대한 GitHub 워크플로 계획을 만듭니다"(이 Prompt MCP 사용)
"이제 Local Dev MCP를 사용하여 방금 계획한 API 프로젝트를 구현해 보겠습니다."(Local Dev MCP 사용)
"우리가 만든 플랜으로 TypeScript 프로젝트를 설정하세요"(Local Dev MCP 사용)

MCP를 결합하면 프로젝트를 세부적으로 계획한 다음 Claude 인터페이스를 벗어나지 않고도 이를 구현할 수 있는 강력한 워크플로가 생성됩니다.

🧠 사용 가능한 프롬프트

서버는 AI 도우미가 사용할 수 있는 여러 가지 프롬프트를 제공합니다.

`api-architecture`

TypeScript API에 대한 포괄적인 아키텍처 계획을 생성합니다.

매개변수:

projectName : API 프로젝트의 이름
database : 사용할 데이터베이스(postgres, mysql, mongodb 등)
auth : 인증 방식(jwt, oauth, none)
endpoints : 주요 API 엔드포인트의 쉼표로 구분된 목록

`new-project-setup`

새로운 TypeScript 프로젝트에 대한 포괄적인 설정 계획을 생성합니다.

매개변수:

projectName : 프로젝트 이름
projectType : 프로젝트 유형(API, 프런트엔드, 라이브러리, CLI)
features : 쉼표로 구분된 주요 기능 또는 요구 사항

`github-workflow`

TypeScript 프로젝트에 대한 GitHub 워크플로 계획을 생성합니다.

매개변수:

projectName : 프로젝트 이름
ciFeatures : CI 기능(lint, test, build 등)을 쉼표로 구분한 목록입니다.
deployTarget : 배포 대상(netlify, vercel, aws, azure 등)
branchStrategy : 브랜치 전략(gitflow, trunk, github-flow)

🔍 작동 원리

서버는 ModelContextProtocol SDK를 사용하여 MCP 서버를 생성합니다.

검증을 위해 zod를 사용하여 매개변수를 포함하는 구조화된 프롬프트를 정의합니다.
각 프롬프트는 AI 도우미가 포괄적인 계획을 생성하는 데 도움이 되는 형식화된 메시지를 반환합니다.
프롬프트에는 계획에 포함할 내용에 대한 자세한 지침이 포함되어 있습니다.
서버는 전송(일반적으로 stdio)을 통해 Claude 또는 기타 MCP 호환 AI 어시스턴트에 연결됩니다.

🛠️ 프로젝트 구조

src/
  ├── index.ts                # Entry point that sets up the MCP server
  ├── prompts/                # Prompt definitions
  │   ├── apiArchitecture.ts  # API architecture prompt
  │   ├── githubWorkflow.ts   # GitHub workflow prompt
  │   ├── newProjectSetup.ts  # New project setup prompt
  │   └── index.ts            # Exports all prompts
scripts/
  ├── prepare-build.ts        # Script for preparing production builds
  ├── run-relevant-tests.ts   # Script for running tests on changed files
  └── setup-husky.js          # Script for setting up Git hooks

⚙️ 개발

새로운 프롬프트 추가

새로운 프롬프트 템플릿을 추가하려면:

src/prompts 디렉토리에 새 파일을 만듭니다.
mcpServer.prompt() 메서드를 사용하여 프롬프트를 정의합니다.
Zod 스키마를 사용하여 매개변수 유효성 검사 추가
src/prompts/index.ts 에 프롬프트를 내보냅니다.

예:

import { z } from 'zod';
import { mcpServer } from '../index';

mcpServer.prompt(
  'my-new-prompt',
  'Description of what this prompt does',
  {
    param1: z.string().describe('Description of param1'),
    param2: z.number().optional().describe('Description of param2'),
  },
  async ({ param1, param2 = 0 }) => {
    return {
      messages: [
        {
          role: 'user',
          content: {
            type: 'text',
            text: `Your prompt template with ${param1} and ${param2}...`,
          },
        },
      ],
    };
  },
);

환경 구성

서버는 개발 및 프로덕션에 서로 다른 환경 파일을 사용합니다.

.env.development - 개발 모드에서 실행할 때 사용됩니다.
.env.production - 프로덕션 모드에서 실행할 때 사용됩니다.

테스트

다음을 사용하여 테스트 모음을 실행합니다.

npm test

린팅 및 포맷팅

# Run ESLint
npm run lint

# Fix ESLint errors
npm run lint:fix

# Format code with Prettier
npm run format

# Check formatting
npm run format:check

📝 배포를 위한 참고 사항

프로덕션에 배포할 때:

필요한 경우 .env.production 파일에 유효한 자격 증명이 포함되어 있는지 확인하세요.
빌드 프로세스는 이러한 자격 증명을 컴파일된 코드에 포함합니다.
npm run prod 사용하여 프로덕션 서버를 빌드하고 시작합니다.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

작가

그폴 | 팔딘

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI 어시스턴트가 TypeScript 프로젝트, API 아키텍처, GitHub 워크플로에 대한 포괄적인 계획을 생성할 수 있도록 미리 정의된 프롬프트 템플릿을 제공합니다.

Appeared in Searches

Developing a System Using TypeScript