explainx.aijoin newsletter3.01k
file-systemsdeveloper-tools

Amazon Q Custom Prompt MCP Server▌

by fiet-kyo

Amazon Q Custom Prompt MCP Server — serve markdown prompt templates from local files to provide Amazon Q prompts and cus

Provides custom prompts for Amazon Q by serving markdown files from the local filesystem as prompt templates through the Model Context Protocol.

github stars

★ 0

GitHubnpm
Uses local filesystem storageMarkdown-based prompt format

best for

  • / Developers building Amazon Q integrations
  • / Teams sharing standardized prompt templates
  • / Organizations with custom prompt libraries

capabilities

  • / Load markdown files as prompt templates
  • / Serve local prompt collections to Amazon Q
  • / Organize prompts in filesystem directories
  • / Access custom prompt libraries

what it does

Serves local markdown files as prompt templates for Amazon Q through the Model Context Protocol. Lets you organize and reuse custom prompts stored as files on your system.

about

Amazon Q Custom Prompt MCP Server is a community-built MCP server published by fiet-kyo that provides AI assistants with tools and capabilities via the Model Context Protocol. Amazon Q Custom Prompt MCP Server — serve markdown prompt templates from local files to provide Amazon Q prompts and cus It is categorized under file systems, developer tools.

how to install

You can install Amazon Q Custom Prompt MCP Server in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Amazon Q Custom Prompt MCP Server is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

prompt-mcp

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

개요

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

기능

  • 프롬프트 목록 조회: 저장된 모든 프롬프트 파일 목록을 반환
  • 프롬프트 내용 조회: 특정 프롬프트의 내용을 읽어와 반환
  • 자동 파일 감지: .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