🚀 Claude Custom Prompts MCP Server

Claude Prompts

AI コーディングハーネスの隣で動作する、ポータブルなワークフローレイヤーです。

クライアントは独自のツール、エージェント、コンテキストを使って実行します。
Claude Promptsは、再利用可能なプロンプトリソース、組み合わせ可能なチェーン、検証ゲート、クライアントネイティブなスキルのエクスポートを追加します。

クイックスタート · 利用できる機能 · ワークフローを組み合わせる · どこでも実行 · ドキュメント

AI クライアントでできること — このサーバーが追加する機能

これはどんな人向けですか？

• 次の方におすすめです：同じプロンプトを繰り返し書く方、複数ステップのワークフローを実行する方、再利用可能なプロンプトをチームで共有したい方。
• 次の方にはおすすめしません：クライアント組み込みの/commandsで必要なことがすでにできている方、コード不要のプロンプトライブラリをお探しの方。
• 対応クライアント：Claude Code、Claude Desktop、Cursor、OpenCode、Gemini CLI、Codex、Windsurf、Zed。プラグインインストーラーはClaude Code、OpenCode、Gemini CLI、Codex（実験的）向けのフック（チェーン追跡、ゲートの適用、状態の保持）を追加します。それ以外のクライアントはMCPのみで動作します。

クイックスタート

Claude Code（推奨）

# Add marketplace (first time only)
/plugin marketplace add minipuft/minipuft-plugins

# Install
/plugin install claude-prompts@minipuft

# Try it
>>tech_evaluation_chain library:'zod' context:'API validation'

git clone https://github.com/minipuft/claude-prompts-mcp ~/Applications/claude-prompts-mcp
cd ~/Applications/claude-prompts-mcp/server && npm install && npm run build
claude --plugin-dir ~/Applications/claude-prompts-mcp

Codex（実験的）

CodexのフックにはCodex CLI 0.117以降が必要で、Windowsでは利用できません。PythonとNode.jsの前提条件については、codex-promptsの要件をご覧ください。

~/.codex/config.tomlでフックを有効にします。

[features]
hooks = true

次にプラグインをインストールします。

codex plugin marketplace add https://github.com/minipuft/minipuft-plugins.git
codex plugin add codex-prompts@minipuft

Codexを再起動し、/hooksを実行してプラグインのフックを確認してから、>>tech_evaluation_chain library:'zod' context:'API validation'を試してください。

その他のクライアントのセットアップ

Claude Desktop

オプション A：GitHub リリース（推奨）

1. Releases から claude-prompts-{version}.mcpb をダウンロードします
2. Claude Desktop の「設定」→「MCP サーバー」にドラッグします
3. 完了です

.mcpb バンドルは自己完結型（約 5MB）のため、npm は不要です。

オプション B：NPX（自動更新）

設定ファイルに追加します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-prompts": {
      "command": "npx",
      "args": ["-y", "claude-prompts@latest", "--client", "claude-code"]
    }
  }
}

Claude Desktop を再起動し、>>research_chain topic:'remote team policies' をテストします。

# OpenCode (full hooks)
npm install -g opencode-prompts && opencode-prompts install

# Gemini CLI (partial hooks)
gemini extensions install https://github.com/minipuft/gemini-prompts

git clone https://github.com/minipuft/claude-prompts-mcp.git
cd claude-prompts-mcp/server && npm install && npm run build && npm test

カスタムリソース：--init=~/my-prompts で、3 つのプロンプト例と config.jsonc を含むスターターワークスペースを作成します。編集する（YAML スキーマ）か、AI に resource_manager を使って新しいプロンプト、ゲート、フレームワークを作成させます。すでに適切な形式のワークスペースがある場合は、MCP_RESOURCES_PATH をその場所に指定します。カスタムリソースガイドを参照してください。

利用できるもの

作成、バージョン管理、組み合わせが可能な4つのプリミティブが用意されています。同梱セットには9カテゴリにわたる52個のプロンプトが含まれています。これは出発点となるライブラリであり、上限ではありません。作業を進めるなかで、AI が resource_manager を通じて新しいプロンプトを作成し、連鎖させるため、実際の作業に合わせてセットが成長します。すべてホットリロードに対応し、ロールバック可能なバージョン管理が行われます。

プロンプト、ゲート、フレームワークは resource_manager ツールを通じて管理します。AI は MCP を通じてそれらを作成、編集、バージョン管理、ロールバックできるため、ファイルを編集する必要はありません。スタイルは同梱の cpm CLI で管理します。ゲートのチェックに失敗した場合は、自動的に再試行するか、ユーザーの判断を待つことができます（ゲートガイド）。最初のプリミティブを作成してみましょう：プロンプト作成チュートリアル。

3つのツール

上記のすべては、3つの MCP ツールを通じてクライアントに届きます。

ほとんどのユーザーは会話内で >> 構文を使ってこれらを呼び出し、実際の呼び出しはフックが構築します。プログラムから MCP クライアントを利用してツールを直接呼び出す場合は、MCP ツールリファレンスを参照してください。

ワークフローを組み合わせる

チェーンの書き方

>>review target:'src/auth/' @ReACT :: 'cite sources'
  --> security_scan :: verify:"npm test"
  ==> implementation

上から順に読みます。

• >>review target:'src/auth/' は、認証フォルダーを対象に review プロンプトを実行します。
• @ReACT は、このステップに ReACT 推論フレームワークを適用します。
• :: 'cite sources' は、AI が満たす必要のあるゲート（出典を引用するか、再試行する）を追加します。
• --> security_scan :: verify:"npm test" はステップ 2 につなぎます。このステップでは、出力を生成する前に npm test に合格する必要があります。
• ==> implementation は、最後のステップをクライアントネイティブのエージェント（Claude Code のサブエージェント）に引き渡します。

review はサーバーに同梱されています。security_scan と implementation は、独自に作成するプロンプトの例です。

検証は最後だけでなく、ステップ間でも実行されます。オペレーター構文の全体と使用例については、MCP Tools Reference をご覧ください。

_{ゲートが不足フィールドを検出し、モデルが自ら修正して、チェーンが成功します。最も安価なモデルである haiku で記録しました。}

基本構文を拡張するパターンが 2 つあります。チェーンでは、ステップ間でのコンテキストの引き継ぎと、エージェントへの引き渡しもサポートしています。Chains Lifecycle と MCP Tools Reference をご覧ください。

出力を見る：context7 の調査を使った技術評価チェーン

_{チェーンの途中で Context7 がライブラリの最新ドキュメントを取得します。最終出力は、出典を含む構造化された評価です。}

検証ループ

シェルコマンドを使ったグラウンドトゥルース検証です。テストに合格するまで AI が反復します。

>>implement-feature :: verify:"npm test" loop:true

実装してテストを実行し、失敗を読み取って修正し、再試行します。繰り返し失敗した場合は、コンテキストの劣化を防ぐため、新しいコンテキストを開始します。

implement-feature は独自のプロンプトの例です。:: verify を追加すると、どのプロンプトにも適用できます。

コンテキストの劣化を防ぎながら、自律的にテストと修正を繰り返すサイクルについては、Ralph Loops Guide をご覧ください。

Judge モード

タスクに適したリソースを AI に選ばせます。

%judge Help me refactor this authentication module

利用可能なテンプレート、推論フレームワーク、検証ルール、スタイルを分析し、最適な組み合わせを提案します。実行前に確認できます。スコアリングと上書きについては、Judge Mode Guide をご覧ください。

どこでも実行

ワークフローを YAML テンプレートとして作成し、クライアントのネイティブスキルとしてエクスポートします。

# skills-sync.yaml — choose what to export
registrations:
  claude-code:
    user:
      - prompt:development/review
      - prompt:development/validate_work

npm run skills:export

review プロンプトは /review Claude Code スキルになります。validate_work は /validate_work になります。同じソースからネイティブな使い心地を実現し、実行時に MCP を呼び出す必要はありません。

Claude Code、Cursor、Codex、OpenCode 向けのネイティブスキルパッケージにコンパイルします。npm run skills:diff は、エクスポートした内容がソースと異なる場合に通知します。設定、対応クライアント、差分の検出については、Skills Sync Guide をご覧ください。

フックあり

フックがない場合、3 つの MCP ツールを明示的に呼び出します（各呼び出しは LLM が構成します）。フックを使うと、演算子を会話の中で使えます。>>、-->、==>、:: が仲介を介さず自然に使えるようになり、ワークフローの状態は LLM のターンやコンテキストの圧縮をまたいで保持されます。

フックで実現できること：

フックはプラグインのインストール時に同梱されます。Claude Code（このリポジトリ）と OpenCode では完全にサポートされています。Gemini CLI では一部サポートされています。Codex では実験的にサポートされていますが、Codex のフックはデフォルトで無効になっており、インストールごとに一度だけ /hooks の信頼性レビューが必要です。その他のクライアントでは 3 つの MCP ツールを利用できますが、フックによる動作は利用できません。詳細：hooks/README.md。

仕組み

演算子を使ったコマンド → サーバーが解析し、リソース（フレームワーク、ゲート、スタイル）を注入 → クライアントがレンダリングされたプロンプトを実行し、ゲートに照らして自己評価 → ルーターが判定：合格なら次のステップ、不合格なら再試行、完了なら結果を返します。

リクエストのライフサイクル全体、パイプラインの各段階、サブシステムの図：アーキテクチャの概要。

ドキュメント

何をしたいかに応じてガイドを選んでください。実際に作りながら学ぶ、タスクを完了する、構文を調べる、または設計を理解するためのガイドがあります。

→ docs/README.md

クイックリンク：最初のプロンプトを作成する · チェーンのライフサイクル · MCP ツールのリファレンス · アーキテクチャの概要 · トラブルシューティング

コントリビューション

cd server
npm install
npm run build        # esbuild bundles to dist/index.js
npm test             # Run test suite
npm run validate:all # Full CI validation

ビルドによって自己完結型のバンドルが生成されます。server/dist/ は Git の追跡対象外であり、CI はソースから新たにビルドします。

ワークフローの詳細は CONTRIBUTING.md を参照してください。

ライセンス

MIT