prompts-mcp-server

Un servidor MCP (Model Context Protocol) de propósito general que genera y gestiona automáticamente un sistema de prompts para cualquier proyecto de software, permitiendo que los asistentes de programación de IA mantengan un contexto persistente entre sesiones de desarrollo.

Características

• Escaneo inteligente de proyectos — Identifica automáticamente la pila tecnológica, los frameworks, las bases de datos y las herramientas de construcción del proyecto objetivo.

• Persistencia de contexto — Mantiene un enlace completo del contexto del proyecto, el historial de conversaciones y el historial de cambios de los módulos.

• Verificación de clarificación de requisitos — Mecanismo de confirmación de requisitos basado en 5 criterios para evitar el desarrollo a ciegas.

• Generación de planes — Genera planes ejecutables tras la confirmación de los requisitos, esperando la aprobación del usuario antes de la implementación.

• Sistema de ventana deslizante — Mantiene los últimos 5 registros de conversación y 10 resúmenes de estado, con rotación automática.

• Seguimiento a nivel de módulo — Registra el historial de cambios por módulos funcionales para facilitar la trazabilidad.

• Modo de interfaz dual — Soporta tanto el uso como servidor MCP (protocolo stdio) como a través de CLI.

• Inicialización no destructiva — No sobrescribe archivos existentes al generar archivos de prompts.

Herramientas MCP

Instalación

npm install
npm run build

Uso

Integración como servidor MCP

Añadir a la configuración del asistente de IA (como Cline, Claude Desktop, etc.):

{
  "mcpServers": {
    "prompts-mcp": {
      "command": "node",
      "args": ["/path/to/prompts-mcp-server/build/index.js"],
      "env": {
        "PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

Uso como CLI

# 初始化 prompts 系统
npm run cli init [--project-root /path]

# 加载所有上下文
npm run cli bootstrap

# 需求检查
npm run cli check "任务描述"

# 生成计划
npm run cli plan "任务描述"

# 记录对话
npm run cli log --title "xxx" --request "xxx" [--changes ...]

# 模块日志
npm run cli module-log <module> --change "xxx"
npm run cli module-read <module>
npm run cli module-list

# TODO 管理
npm run cli todos add|complete|remove "todo text"

Modo de desarrollo

npm run dev        # 运行 MCP Server
npm run dev:cli    # 运行 CLI

Variables de entorno

Estructura de archivos generada

Tras la inicialización, se generará en el directorio .github/prompts/ del proyecto objetivo:

.github/prompts/
├── context.md           # 项目上下文：技术栈、规则、TODO、日志索引
├── workflow-log.md      # 工作流规则和 AI 对话规范
├── recent-5.md          # 最近 5 条对话记录（滚动窗口）
├── summary-10.md        # 每 10 条的状态摘要
├── log-state.json       # JSON 状态追踪
├── todos.md             # TODO 列表
├── dev-rules.md         # 自动生成的开发规则
├── daily/               # 每日完整日志
│   └── YYYY-MM-DD.md
└── modules/             # 各模块变更历史
    └── <module-name>.md

Pila tecnológica

• TypeScript (ES2022, ESM)

• @modelcontextprotocol/sdk — SDK oficial de MCP

• Node.js runtime

Licencia

MIT