AI-SDLC Prompts MCP Server
# AI-SDLC Prompts — servidor MCP
[](https://www.bestpractices.dev/projects/16968)
[](https://github.com/dleon55/ai-sdlc-mcp/actions/workflows/ci.yml)
[](https://github.com/dleon55/ai-sdlc-mcp/actions/workflows/codeql.yml)
[](https://www.npmjs.com/package/ai-sdlc-prompts-mcp)
Expone la biblioteca de prompts [AI-SDLC Pro](https://prompts.lionsystems.com.mx/) (112 prompts, ES/EN) a agentes de IA (Claude Code, Claude Desktop, Cursor, etc.) vía [Model Context Protocol](https://modelcontextprotocol.io), transporte stdio.
Solo lectura: ningún tool escribe en el repositorio, en GitHub ni en ningún sistema externo. Todo el contenido se sirve desde `data/prompts-full.json`, una instantánea generada por el sitio de la biblioteca — este servidor nunca parsea Markdown por su cuenta.
Todo prompt que sale de aquí viaja con su **contrato de operación**: techo de
autonomía, herramientas permitidas, criterios de detención y evidencia mínima.
Es el mismo bloque que pega quien copia desde el sitio, y `resolve_prompt` lo
anexa por defecto — ver [Contrato de operación](#contrato-de-operación).
## Instalación
> Publicado en npm: [`ai-sdlc-prompts-mcp`](https://www.npmjs.com/package/ai-sdlc-prompts-mcp).
>
> Licencia: el código de este servidor es **MIT**; los prompts que sirve son
> **CC BY 4.0** (uso comercial permitido, con atribución). Ver [`LICENSE`](LICENSE) y [`NOTICE.md`](NOTICE.md).
Sin clonar el repositorio:
```bash
npx ai-sdlc-prompts-mcp
```
Desde el clon local:
```bash
git clone https://github.com/dleon55/ai-sdlc-mcp.git
cd ai-sdlc-mcp
npm install
```
## Ejecutar
```bash
npm start
# equivalente a: node index.js
```
El proceso escucha en stdin/stdout (protocolo MCP) — no expone HTTP ni requiere red. Se cierra con `Ctrl+C` o cuando el cliente cierra la conexión.
## Configurar en Claude Code / Claude Desktop
Agrega esto a la configuración de servidores MCP del cliente (`claude_desktop_config.json` o el equivalente de Claude Code), ajustando la ruta absoluta al checkout local:
```json
{
"mcpServers": {
"ai-sdlc-prompts": {
"command": "node",
"args": ["/ruta/absoluta/a/ai-sdlc-mcp/index.js"]
}
}
}
```
Con el paquete de npm, sin ruta absoluta ni clon:
```json
{
"mcpServers": {
"ai-sdlc-prompts": {
"command": "npx",
"args": ["-y", "ai-sdlc-prompts-mcp"]
}
}
}
```
## Contrato de operación
Cada uno de los 112 prompts declara en su contrato editorial hasta dónde puede
llegar el agente. `resolve_prompt` anexa ese contrato al texto que devuelve:
```markdown
## 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…
```
Importa más por MCP que en el navegador: quien copia desde el sitio pega y lee;
un agente que pide el prompt por MCP normalmente **ejecuta**. Entregarlo sin su
techo de autonomía es la peor de las dos rutas para perderlo.
No se le ordena obedecer *por encima de todo*: si la tarea contradice al
contrato, el agente debe declararlo, no elegir en silencio. Hay pruebas que
impiden que alguien lo redacte así (`tests/test_mcp_contract_parity.py`).
Se desactiva con `append_contract: false` — pensado para inspeccionar el texto
crudo, no para uso normal.
## Herramientas expuestas
| Herramienta | Descripción |
|---|---|
| `list_prompts` | Lista prompts, con filtro opcional por sección (`00`-`17`), riesgo (`low`/`medium`/`high`/`variable`), autonomía (`A0`-`A3`) y texto libre. |
| `get_prompt` | Detalle completo de un prompt por `id`: título, descripción, texto crudo (placeholders sin resolver), fórmulas de uso, contrato editorial y siguiente(s) prompt(s) recomendado(s). |
| `resolve_prompt` | Sustituye los placeholders del prompt (y opcionalmente el preámbulo del framework) con variables provistas — misma sustitución que hace el sitio. Devuelve el texto resuelto y los placeholders obligatorios/opcionales que quedaron sin resolver. |
| `get_framework` | Preámbulo obligatorio del framework (el bloque que el sitio antepone a cada prompt copiado). |
| `recommend_next` | Prompt(s) recomendado(s) por el contrato editorial para continuar después de uno dado. |
### Variables de `resolve_prompt`
Las claves de `variables` son los **campos canónicos** del sistema de variables del sitio, no los alias `[EN MAYÚSCULAS]` que aparecen en el texto del prompt:
`repositorio`, `referencia`, `rama_actual`, `rama_destino`, `ambiente`, `componentes`, `modulo`, `stack`, `tipo_proyecto`, `metodologia`, `agentes`, `autonomia`, `entrada`, `objetivo`, `responsable`, `workspace`, `compliance`, `documentos`, `profundidad`, `adicionales` (líneas `TOKEN=valor` para placeholders no cubiertos por los campos anteriores).
Ejemplo:
```json
{
"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"
}
}
```
## ¿Prefieres skills?
Si tu agente admite *skills* (`SKILL.md`), los mismos prompts están empaquetados por fase en [dleon55/ai-sdlc-skills](https://github.com/dleon55/ai-sdlc-skills) para Claude Code (marketplace de plugins) y Codex (`~/.agents/skills`). No requieren servidor; el MCP sigue siendo útil para `resolve_prompt` y `recommend_next`.
## Desarrollo
```bash
npm test # node --test test/ -- 29 tests: dataStore, resolvePrompt, integración MCP real (InMemoryTransport)
```
Los datos (`data/prompts-full.json`) se regeneran en el repositorio de la biblioteca y llegan aquí por PR — no editar ese archivo a mano. Ver [`CONTRIBUTING.md`](CONTRIBUTING.md).
## Alcance de esta primera versión
- Se ejecuta en la máquina de quien lo usa (`npx -y ai-sdlc-prompts-mcp`, o `node index.js` desde el clon).
- Transporte stdio únicamente — sin servidor HTTP.
## English
**AI-SDLC Prompts MCP server** exposes the AI-SDLC Pro library (112 software
development lifecycle prompts, Spanish/English) to AI agents (Claude Code,
Claude Desktop, Cursor, …) over the Model Context Protocol (stdio). It is
read-only and never touches the network.
- Run without cloning: `npx ai-sdlc-prompts-mcp`
- Client config: `{"mcpServers":{"ai-sdlc-prompts":{"command":"npx","args":["-y","ai-sdlc-prompts-mcp"]}}}`
- Tools: `list_prompts`, `get_prompt`, `resolve_prompt` (fills placeholders and
appends the operating contract), `get_framework`, `recommend_next` — see the
tool table above.
- Develop: `npm ci && npm test && npm run lint` (see `CONTRIBUTING.md`).
- License: code MIT (`LICENSE`); embedded prompts CC BY 4.0 (`NOTICE.md`).
- Bug reports, feature requests and code comments are welcome **in English or
Spanish** via [GitHub issues](https://github.com/dleon55/ai-sdlc-mcp/issues).
Security reports: privately, see `SECURITY.md`.
## Contribuir y seguridad
- Contribuciones, pruebas y estilo: [`CONTRIBUTING.md`](CONTRIBUTING.md)
- Reporte privado de vulnerabilidades: [`SECURITY.md`](SECURITY.md)
- Cambios por versión: [`CHANGELOG.md`](CHANGELOG.md)
- Issues: <https://github.com/dleon55/ai-sdlc-mcp/issues>
TDQS
Scored across 5 tools
Each tool has a clearly distinct role: listing with filters, fetching full detail, retrieving the framework preamble, following editorial recommendations, and resolving placeholders. The potentially confusable pair (get_prompt vs resolve_prompt) is explicitly separated by 'texto crudo con placeholders sin resolver' versus 'sustituye los placeholders'.
Four of five names follow a clean verb_noun pattern (list_prompts, get_prompt, get_framework, resolve_prompt) in consistent snake_case. recommend_next is verb+adverb without an object noun, a minor deviation from an otherwise predictable scheme.
Five tools is a tight, well-scoped surface for a read-only prompt library: browse, read, resolve, navigate, and load the framework preamble. No tool appears redundant and none feels missing for the stated purpose.
Core lifecycle for consuming the library is covered end-to-end: discover via filters, inspect, resolve placeholders, and jump to the next recommended prompt. Minor gaps remain, such as no way to enumerate sections or the canonical variable/placeholder schema without first calling resolve_prompt on a specific prompt.