AI-SDLC Prompts

AI-SDLC Prompts — MCP サーバー

AI-SDLC Pro のプロンプトライブラリ（112 個のプロンプト、ES/EN）を、Model Context Protocol の stdio トランスポート経由で AI エージェント（Claude Code、Claude Desktop、Cursor など）に公開します。

読み取り専用です。どのツールも、リポジトリ、GitHub、その他の外部システムへの書き込みは行いません。コンテンツはすべて data/prompts-full.json から提供されます。このファイルはリポジトリのルートで python build.py を実行して生成されます。このサーバーが独自に Markdown を解析することはありません。

ここから提供されるすべてのプロンプトには、運用契約が付属します。自律性の上限、許可されるツール、停止基準、最低限必要な証拠が記載されています。サイトからコピーするユーザーが貼り付けるものと同じ内容であり、resolve_prompt はデフォルトでこれを追加します。運用契約をご覧ください。

インストール

npm で公開されています：ai-sdlc-prompts-mcp。

ライセンス：このサーバーのコードは MIT です。提供するプロンプトは CC BY 4.0（商用利用可、帰属表示が必要）です。LICENSE をご覧ください。

リポジトリをクローンせずにインストールする場合：

npx ai-sdlc-prompts-mcp

ローカルのクローンからインストールする場合：

cd mcp-server
npm install

実行

npm start
# equivalente a: node index.js

プロセスは標準入力／標準出力（MCP プロトコル）で待ち受けます。HTTP は公開せず、ネットワーク接続も必要ありません。Ctrl+C を押すか、クライアントが接続を閉じると終了します。

Claude Code／Claude Desktop での設定

クライアントの MCP サーバー設定（claude_desktop_config.json または Claude Code の同等の設定）に以下を追加し、ローカルのチェックアウト先の絶対パスに合わせて変更してください：

{
  "mcpServers": {
    "ai-sdlc-prompts": {
      "command": "node",
      "args": ["/ruta/absoluta/a/ai-sdlc-prompts/mcp-server/index.js"]
    }
  }
}

絶対パスもクローンも不要な npm パッケージを使用する場合：

{
  "mcpServers": {
    "ai-sdlc-prompts": {
      "command": "npx",
      "args": ["-y", "ai-sdlc-prompts-mcp"]
    }
  }
}

運用契約

112 個のプロンプトはそれぞれ、編集上の契約でエージェントが実行できる範囲を定めています。resolve_prompt は、返すテキストにこの契約を追加します：

## Contrato de operación

Estas restricciones vienen del contrato editorial de este prompt.
Si la tarea las contradice, decláralo en vez de excederlas.

- **Autonomía máxima:** A1 — Proponer
- **Herramientas permitidas:** lectura opcional de la estructura actual…
- **Detente y pregunta cuando:** si el tipo de proyecto o el stack son ambiguos…
- **Evidencia mínima de tu salida:** el árbol de directorios y la tabla…

ブラウザーで使う場合よりも、MCP 経由では重要です。サイトからコピーするユーザーは貼り付けて読むだけですが、MCP 経由でプロンプトを要求するエージェントは通常、それを実行します。自律性の上限を付けずに渡すことは、上限を失う二つの方法のうち最悪のものです。

「何よりも優先して従え」と指示するものではありません。タスクが契約に反する場合、エージェントは黙って選択するのではなく、その旨を明示する必要があります。そのような契約が書かれないよう、テストで防止しています（tests/test_mcp_contract_parity.py）。

append_contract: false で無効にできます。これは生のテキストを確認するためのもので、通常の使用には適しません。

提供するツール

ツール	説明
list_prompts	プロンプトを一覧表示します。セクション（00-17）、リスク（low／medium／high／variable）、自律性（A0-A3）、自由入力テキストで絞り込めます。
get_prompt	id で指定したプロンプトの詳細（タイトル、説明、未解決のプレースホルダーを含む生のテキスト、使用方法の式、編集上の契約、おすすめの次のプロンプト）を取得します。
resolve_prompt	指定した変数を使って、プロンプト内のプレースホルダー（および任意でフレームワークの前文）を置換します。サイトと同じ置換処理を行います。解決済みのテキストと、未解決の必須／任意のプレースホルダーを返します。
get_framework	フレームワークの必須の前文を取得します（サイトでコピーした各プロンプトの先頭に付加されるブロック）。
recommend_next	指定したプロンプトの後に続けるために、編集上の契約でおすすめされているプロンプトを取得します。

resolve_prompt の変数

variables のキーには、プロンプト本文に表示される [大文字の別名] ではなく、サイトの変数システムで使われる正規フィールドを指定します：

repositorio、referencia、rama_actual、rama_destino、ambiente、componentes、modulo、stack、tipo_proyecto、metodologia、agentes、autonomia、entrada、objetivo、responsable、workspace、compliance、documentos、profundidad、adicionales（上記のフィールドでカバーされないプレースホルダーに対する TOKEN=valor 形式の行）。

例：

{
  "id": "07-06-pruebas-performance-carga",
  "lang": "es",
  "variables": {
    "repositorio": "org/mi-repo",
    "ambiente": "staging",
    "adicionales": "PATRON DE CARGA=1000 req/s durante 10 min"
  }
}

開発

npm test    # node --test test/ -- 29 tests: dataStore, resolvePrompt, integración MCP real (InMemoryTransport)

データ（data/prompts-full.json）は、リポジトリのルートから python build.py を実行して再生成します。このファイルを手動で編集しないでください。プロンプトの内容を変更する場合は、ai_sdlc_pro_prompts/*.md を編集してください。

この初回バージョンの範囲

• 使用する人のマシン上で実行されます（npx -y ai-sdlc-prompts-mcp、またはクローンから node index.js を実行）。
• トランスポートは stdio のみです。HTTP サーバーはありません。