MCP Prompt Engine

🚀 MCP Prompt Engine

エレガントで強力なテキストテンプレートエンジンを使用して、動的なプロンプトテンプレートを管理および提供するためのModel Control Protocol (MCP)サーバーです。変数、パーシャル、条件文を使用して再利用可能なロジック駆動型のプロンプトを作成し、Claude Code、Claude Desktop、Gemini CLI、Copilot付きのVSCodeなどの互換性のあるMCPクライアントに提供することができます。

🚀 クイックスタート

1. インストール

Goを使用してインストールします。

go install github.com/vasayxtx/mcp-prompt-engine@latest

（Dockerや事前ビルド済みのバイナリなど、他の方法については、以下のインストールセクションを参照してください。）

2. プロンプトの作成

promptsディレクトリを作成し、テンプレートファイルを追加します。ここでは、Gitコミットメッセージを作成するためのプロンプトを作成しましょう。 まず、prompts/_git_commit_role.tmplという名前の再利用可能なパーシャルを作成します。

{{ define "_git_commit_role" }}
You are an expert programmer specializing in writing clear, concise, and conventional Git commit messages.
Commit message must strictly follow the Conventional Commits specification.

The final commit message you generate must be formatted exactly as follows:

: A brief, imperative-tense summary of changes

[Optional longer description, explaining the "why" of the change. Use dash points for clarity.]

{{ if .type -}}
Use {{.type}} as a type.
{{ end }}
{{ end }}

次に、このパーシャルを使用するメインのプロンプトprompts/git_stage_commit.tmplを作成します。

{{- /* Commit currently staged changes */ -}}

{{- template "_git_commit_role" . -}}

Your task is to commit all currently staged changes.
To understand the context, analyze the staged code using the command: `git diff --staged`
Based on that analysis, commit staged changes using a suitable commit message.

3. プロンプトの検証

プロンプトに構文エラーがないことを確認するために検証します。

mcp-prompt-engine validate git_stage_commit
✓ git_stage_commit.tmpl - Valid

4. MCPサーバーをクライアントに接続する

MCPサーバーをMCPクライアントに追加します。構成例については、クライアントへの接続を参照してください。

5. プロンプトの使用

これで、git_stage_commitプロンプトがクライアントで使用可能になりました！ たとえば、Claude Desktopでは、git_stage_commitプロンプトを選択し、type MCPプロンプト引数を指定すると、完璧なメッセージでコミットを行うのに役立つ生成されたプロンプトを取得できます。 Claude CodeまたはGemini CLIでは、/git_stage_commitと入力すると、指定された引数付きのプロンプトが提案され、選択すると実行されます。

✨ 主な機能

• MCP互換性：プロンプトをサポートする任意のMCPクライアントでそのまま使用できます。
• 強力なGoテンプレート：Goのtext/template構文の全機能を利用し、変数、条件文、ループなどをサポートします。
• 再利用可能なパーシャル：パーシャルテンプレート（例：_header.tmpl）で共通のコンポーネントを定義し、プロンプト全体で再利用できます。
• プロンプト引数：すべてのテンプレート変数は自動的にMCPプロンプト引数として公開され、クライアントからの動的入力を可能にします。
• ホットリロード：プロンプトファイルの変更を自動的に検出し、サーバーを再起動することなく再読み込みします。
• 充実したCLI：テンプレートをリストアップ、検証、レンダリングするための最新のコマンドラインインターフェイスがあり、開発とテストが容易です。
• スマートな引数処理：
  • JSON引数（ブール値、数値、配列、オブジェクト）を自動的に解析します。
  • 環境変数をテンプレート引数のフォールバックとして注入します。
• コンテナ化：簡単なデプロイと統合のために、完全なDockerサポートがあります。

📦 インストール

事前ビルド済みのバイナリ

GitHub Releasesページから、あなたのOS用の最新リリースをダウンロードします。

ソースからビルド

git clone https://github.com/vasayxtx/mcp-prompt-engine.git
cd mcp-prompt-engine
make build

Docker

事前ビルド済みのDockerイメージが利用可能です。ローカルのpromptsとlogsディレクトリをコンテナにマウントします。

# Pull and run the pre-built image from GHCR
docker run -i --rm \
  -v /path/to/your/prompts:/app/prompts:ro \
  -v /path/to/your/logs:/app/logs \
  ghcr.io/vasayxtx/mcp-prompt-engine

make docker-buildでローカルでイメージをビルドすることもできます。

💻 使用例

基本的な使用法

プロンプトテンプレートの作成

プロンプトテンプレートを格納するディレクトリを作成します。各テンプレートは、Goのtext/template構文を使用した.tmplファイルで、以下の形式にする必要があります。

{{/* Brief description of the prompt */}}
Your prompt text here with {{.template_variable}} placeholders.

最初の行のコメント ({{/* description */}}) はプロンプトの説明として使用され、ファイルの残りの部分はプロンプトテンプレートです。 パーシャルテンプレートはアンダースコアで始める必要があり（例：_header.tmpl）、{{template "partial_name" .}}を使用して他のテンプレートに含めることができます。

テンプレート構文

サーバーはGoのtext/templateエンジンを使用しており、強力なテンプレート機能を提供します。

• 変数：{{.variable_name}} - テンプレート変数にアクセスします。
• 組み込み変数：
  • {{.date}} - 現在の日付と時刻
• 条件文：{{if .condition}}...{{end}}, {{if .condition}}...{{else}}...{{end}}
• 論理演算子：{{if and .condition1 .condition2}}...{{end}}, {{if or .condition1 .condition2}}...{{end}}
• ループ：{{range .items}}...{{end}}
• テンプレートの包含：{{template "partial_name" .}} または {{template "partial_name" dict "key" "value"}} 構文と機能の詳細については、Go text/templateドキュメントを参照してください。

JSON引数の解析

サーバーは可能な場合、引数値をJSONとして自動的に解析し、テンプレートで豊富なデータ型を使用できるようにします。

• ブール値：true, false → Goのブール値
• 数値：42, 3.14 → Goの数値
• 配列：["item1", "item2"] → {{range}}で使用するためのGoのスライス
• オブジェクト：{"key": "value"} → 構造化データのためのGoのマップ
• 文字列：無効なJSONは文字列値にフォールバックします。 これにより、次のような高度なテンプレート操作が可能になります。

{{range .items}}Item: {{.}}{{end}}
{{if .enabled}}Feature is enabled{{end}}
{{.config.timeout}} seconds

JSON解析を無効にし、すべての引数を文字列として扱うには、serveおよびrenderコマンドに--disable-json-argsフラグを使用します。

CLIコマンド

CLIは、テンプレートを管理およびテストするための主要なツールです。 デフォルトでは、./promptsディレクトリ内のテンプレートを探しますが、--promptsフラグで別のディレクトリを指定することができます。

1. テンプレートのリスト表示

# See a simple list of available prompts
mcp-prompt-engine list

# See a detailed view with descriptions and variables
mcp-prompt-engine list --verbose

2. テンプレートのレンダリング ターミナルで直接プロンプトをレンダリングし、-aまたは--argフラグで引数を指定します。 欠落している引数には、自動的に環境変数がフォールバックとして注入されます。たとえば、環境変数TYPE=fixがある場合、{{.type}}としてテンプレートに注入されます。

# Render the git commit prompt, providing the 'type' variable
mcp-prompt-engine render git_stage_commit --arg type=feat

3. テンプレートの検証 すべてのテンプレートの構文エラーをチェックします。いずれかのテンプレートが無効な場合、コマンドはエラーを返します。

# Validate all templates in the directory
mcp-prompt-engine validate

# Validate a single template
mcp-prompt-engine validate git_stage_commit

4. サーバーの起動 MCPサーバーを実行して、クライアントがプロンプトを利用できるようにします。

# Run with default settings (looks for ./prompts)
mcp-prompt-engine serve

# Specify a different prompts directory and a log file
mcp-prompt-engine --prompts /path/to/prompts serve --log-file ./server.log

📚 ドキュメント

クライアントへの接続

このエンジンをMCPプロンプトをサポートする任意のクライアントで使用するには、そのMCPサーバー構成に新しいエントリを追加します。 グローバルな構成場所（MacOS）：

• Claude Code: ~/.claude.json (mcpServersセクション)
• Claude Desktop: ~/Library/Application\ Support/Claude/claude_desktop_config.json (mcpServersセクション)
• Gemini CLI: ~/.gemini/settings.json (mcpServersセクション)

ローカルバイナリの例:

{
  "prompts": {
    "command": "/path/to/your/mcp-prompt-engine",
    "args": [
      "--prompts", "/path/to/your/prompts",
      "serve",
      "--quiet"
    ]
  }
}

Dockerの例:

{
  "mcp-prompt-engine-docker": {
    "command": "docker",
    "args": [
      "run", "-i", "--rm",
      "-v", "/path/to/your/prompts:/app/prompts:ro",
      "-v", "/path/to/your/logs:/app/logs",
      "ghcr.io/vasayxtx/mcp-prompt-engine"
    ]
  }
}

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。