prompt-mcp

Amazon Q용 커스텀 프롬프트를 위한 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 Amazon Q에서 사용할 수 있는 커스텀 프롬프트를 관리하고 제공합니다. ~/.aws/amazonq/prompts/ 디렉토리에 저장된 마크다운 파일들을 읽어와 MCP 클라이언트에게 프롬프트로 제공합니다.

Related MCP server: PromptLab MCP Server

기능

• 프롬프트 목록 조회: 저장된 모든 프롬프트 파일 목록을 반환

• 프롬프트 내용 조회: 특정 프롬프트의 내용을 읽어와 반환

• 자동 파일 감지: .md 확장자를 가진 파일들을 자동으로 프롬프트로 인식

설치 및 실행

방법 1: NPM 패키지 사용 (권장)

.npmrc 설정 (필수)

GitHub Packages에서 패키지를 설치하려면 .npmrc 파일 설정이 필요합니다:

# 프로젝트 루트 또는 홈 디렉토리에 .npmrc 파일 생성
echo "@juvisdiet:registry=https://npm.pkg.github.com" >> .npmrc
echo "//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN" >> .npmrc

또는 글로벌 설정:

npm config set @juvisdiet:registry https://npm.pkg.github.com
npm config set //npm.pkg.github.com/:_authToken YOUR_GITHUB_TOKEN

패키지 사용

# MCP 설정에서 직접 사용
npx @juvisdiet/q-developer-commands

MCP 클라이언트 설정

{
  "mcpServers": {
    "prompt-mcp": {
      "command": "npx",
      "args": ["-y", "@juvisdiet/q-developer-commands"]
    }
  }
}

프롬프트 파일 구조

프롬프트 파일은 ~/.aws/amazonq/prompts/ 디렉토리에 .md 확장자로 저장됩니다.

파일 위치

~/.aws/amazonq/prompts/
├── development-rules.md
├── hello.md
└── pr.md

파일 형식

프롬프트 파일은 마크다운 형식으로 작성하며, YAML front matter가 있는 경우 자동으로 제거됩니다.

---
title: 예시 프롬프트
---

여기에 실제 프롬프트 내용을 작성합니다.

기술 스택

• Node.js: JavaScript 런타임

• @modelcontextprotocol/sdk: MCP 프로토콜 구현

• ES Modules: 모던 JavaScript 모듈 시스템

에러 처리

• 프롬프트 디렉토리가 존재하지 않는 경우 빈 목록 반환

• 요청한 프롬프트 파일이 없는 경우 에러 메시지 반환

• 파일 읽기 실패 시 적절한 에러 메시지 제공

라이선스

MIT License