explainx.ainewsletter3.4k
file-systemsdeveloper-tools

Amazon Q Custom Prompt MCP Server▌

fiet-kyo

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
0 commentsdiscussion

Both formats append explainx.ai attribution and the canonical URL for this MCP server listing.

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

FAQ

What is the Amazon Q Custom Prompt MCP Server MCP server?
Amazon Q Custom Prompt MCP Server is a Model Context Protocol (MCP) server profile on explainx.ai. MCP lets AI hosts (e.g. Claude Desktop, Cursor) call tools and resources through a standard interface; this page summarizes categories, install hints, and community ratings.
How do MCP servers relate to agent skills?
Skills are reusable instruction packages (often SKILL.md); MCP servers expose live capabilities. Teams frequently combine both—skills for workflows, MCP for APIs and data. See explainx.ai/skills and explainx.ai/mcp-servers for parallel directories.
How are reviews shown for Amazon Q Custom Prompt MCP Server?
This profile displays 45 aggregated ratings (sample rows for discoverability plus signed-in user reviews). Average score is about 4.7 out of 5—verify behavior in your own environment before production use.

Use Cases▌

Code & Document Analysis

Read, analyze, and understand files in your project

Example

Summarize README, analyze code structure, find TODO comments across codebase

✓

Navigate large codebases 5x faster, understand projects quickly

Automated File Operations

Create, move, rename, and organize files based on natural language instructions

Example

Organize downloads by file type, rename files following convention, batch process images

✓

Save hours on manual file organization

Content Search & Extraction

Search files for patterns, extract data, find information across directories

Example

Find all config files with API keys, extract emails from documents, search logs for errors

✓

Find information instantly instead of manual grep/find

File Generation & Templates

Generate boilerplate files, apply templates, create project structures

Example

Create React component with tests and styles, generate OpenAPI spec, scaffold new project

✓

Eliminate repetitive file creation work

Implementation Guide▌

Prerequisites

  • ›Claude Desktop or Cursor with MCP support
  • ›File system permissions for directories you want to access
  • ›Understanding of file paths and directory structure
  • ›Backup of important files before bulk operations

Time Estimate

10-20 minutes including configuration

Installation Steps

  1. 1.Install filesystem MCP server (often built-in with Claude Desktop)
  2. 2.Configure allowed directories in MCP config for security
  3. 3.Test read: 'Show me contents of ~/Documents/test.txt'
  4. 4.Test write: 'Create a new file notes.md in current directory'
  5. 5.Test search: 'Find all .js files containing TODO'
  6. 6.Test batch operations: 'Rename all .jpeg files to .jpg'
  7. 7.Verify file permissions and access controls

Troubleshooting

  • ⚠Permission denied: Check file/directory permissions, run with appropriate user
  • ⚠Path not found: Verify path is absolute or relative to working directory
  • ⚠MCP server can't access directory: Add to allowed directories in config
  • ⚠File already exists: Use overwrite flag or check before writing
  • ⚠Operation failed: Check disk space, file locks, antivirus interference

Best Practices▌

✓ Do

  • +Configure allowed directories explicitly—don't grant full filesystem access
  • +Back up important files before bulk operations
  • +Use dry-run mode for risky operations when available
  • +Validate file paths before operations
  • +Set appropriate file permissions on created files
  • +Log file operations for audit trail
  • +Test operations on sample files first

✗ Don't

  • −Don't grant MCP access to system directories (/etc, /System)
  • −Don't allow write access to production config files
  • −Don't skip backup before bulk delete/move operations
  • −Don't use for sensitive files (passwords, keys) without encryption
  • −Don't ignore file permission errors—investigate root cause
  • −Don't expose personal documents without considering privacy

💡 Pro Tips

  • ★Use .gitignore patterns to exclude sensitive files from AI access
  • ★Create sandboxed working directory for file experiments
  • ★Combine with version control (git) for easy rollback
  • ★Use file watching for real-time monitoring and reactions
  • ★Create templates for common file generation tasks
  • ★Leverage file metadata (timestamps, size) for smart organization

Technical Details▌

Architecture

MCP server provides file I/O operations (read, write, search, metadata) as tools Claude can invoke with natural language instructions.

Protocols

  • Local file system API
  • Glob patterns for search
  • File streams for large files

Compatibility

  • macOS
  • Linux
  • Windows
  • Local files only (no remote filesystems by default)

When to Use This▌

✓ Use When

Use for code analysis, file organization, content search, template generation, and automating repetitive file operations. Best for local development workflows.

✗ Avoid When

Avoid for system-critical files, sensitive credentials, production environments, or when file integrity is paramount. Don't use on files you can't afford to lose.

Integration▌

  • →Combine with git for version-controlled file operations
  • →Integrate with code editors for seamless workflow
  • →Use with backup tools for safety net
  • →Pair with file watchers for automated reactions

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.

List & Promote Your MCP Server

Share your MCP server with the developer community

GET_STARTED →
MCP server reviews

Ratings

4.7★★★★★45 reviews
  • ★★★★★Dhruvi Jain· Dec 28, 2024

    Strong directory entry: Amazon Q Custom Prompt MCP Server surfaces stars and publisher context so we could sanity-check maintenance before adopting.

  • ★★★★★Olivia Desai· Dec 28, 2024

    Amazon Q Custom Prompt MCP Server has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.

  • ★★★★★Alexander Thompson· Dec 24, 2024

    Amazon Q Custom Prompt MCP Server is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.

  • ★★★★★Zara Li· Dec 12, 2024

    We wired Amazon Q Custom Prompt MCP Server into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.

  • ★★★★★Hiroshi Farah· Nov 27, 2024

    Useful MCP listing: Amazon Q Custom Prompt MCP Server is the kind of server we cite when onboarding engineers to host + tool permissions.

  • ★★★★★Oshnikdeep· Nov 19, 2024

    Amazon Q Custom Prompt MCP Server is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.

  • ★★★★★Zara Wang· Nov 19, 2024

    Amazon Q Custom Prompt MCP Server is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.

  • ★★★★★Ava Khan· Nov 15, 2024

    Amazon Q Custom Prompt MCP Server has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.

  • ★★★★★Arya Torres· Nov 3, 2024

    According to our notes, Amazon Q Custom Prompt MCP Server benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.

  • ★★★★★Mei Sethi· Oct 22, 2024

    Amazon Q Custom Prompt MCP Server has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.

showing 1-10 of 45

1 / 5