prompts-mcp-server

Универсальный MCP (Model Context Protocol) сервер, который автоматически создает и управляет системой промптов для любых программных проектов, позволяя AI-ассистентам программирования сохранять постоянный контекст между сессиями разработки.

Функциональные возможности

• Интеллектуальное сканирование проектов — автоматическое определение технологического стека, фреймворков, баз данных и инструментов сборки целевого проекта.

• Сохранение контекста — поддержание полной цепочки контекста проекта, истории диалогов и истории изменений модулей.

• Проверка уточнения требований — механизм подтверждения требований на основе 5 критериев для предотвращения слепой разработки.

• Генерация плана — создание исполняемого плана после подтверждения требований, ожидание одобрения пользователя перед реализацией.

• Система скользящего окна — ведение 5 последних записей диалога и 10 сводок состояния с автоматической ротацией.

• Отслеживание на уровне модулей — запись истории изменений по функциональным модулям для удобства отслеживания.

• Двухрежимный интерфейс — поддержка MCP Server (протокол stdio) и CLI.

• Неразрушающая инициализация — генерация файлов промптов без перезаписи существующих файлов.

Инструменты MCP

Установка

npm install
npm run build

Использование

Интеграция в качестве MCP Server

Добавьте в конфигурацию AI-ассистента (например, Cline, Claude Desktop и т.д.):

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

Использование в качестве 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"

Режим разработки

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

Переменные окружения

Структура создаваемых файлов

После инициализации в каталоге .github/prompts/ целевого проекта будут созданы:

.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

Технологический стек

• TypeScript (ES2022, ESM)

• @modelcontextprotocol/sdk — официальный MCP SDK

• Node.js runtime

Лицензия

MIT