prompts-mcp-server

Ein universeller MCP-Server (Model Context Protocol), der automatisch ein Prompt-System für jedes Softwareprojekt generiert und verwaltet, sodass KI-Programmierassistenten einen persistenten Kontext über Entwicklungssitzungen hinweg beibehalten können.

Funktionen

• Intelligentes Projekt-Scanning — Automatische Erkennung des Tech-Stacks, Frameworks, der Datenbanken und Build-Tools des Zielprojekts

• Kontext-Persistenz — Aufrechterhaltung einer vollständigen Kette von Projektkontext, Gesprächsprotokollen und Moduländerungshistorien

• Anforderungsklärungsprüfung — Mechanismus zur Anforderungsbestätigung basierend auf 5 Kriterien, um blindes Entwickeln zu vermeiden

• Planerstellung — Erstellung ausführbarer Pläne nach Anforderungsbestätigung, die auf die Zustimmung des Benutzers warten, bevor sie umgesetzt werden

• Rolling-Window-System — Verwaltung der letzten 5 Gesprächsprotokolle und 10 Statuszusammenfassungen mit automatischer Rotation

• Modulbasierte Verfolgung — Aufzeichnung der Änderungshistorie nach Funktionsmodulen zur einfachen Nachverfolgung

• Dual-Interface-Modus — Unterstützt sowohl MCP Server (stdio-Protokoll) als auch CLI-Nutzung

• Nicht-destruktive Initialisierung — Überschreibt beim Generieren von Prompt-Dateien keine bereits vorhandenen Dateien

MCP-Tools

Installation

npm install
npm run build

Verwendung

Integration als MCP-Server

Fügen Sie dies in die Konfiguration Ihres KI-Assistenten (z. B. Cline, Claude Desktop usw.) hinzu:

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

Verwendung als 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"

Entwicklungsmodus

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

Umgebungsvariablen

Generierte Dateistruktur

Nach der Initialisierung wird im Verzeichnis .github/prompts/ des Zielprojekts Folgendes generiert:

.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

Tech-Stack

• TypeScript (ES2022, ESM)

• @modelcontextprotocol/sdk — Offizielles MCP-SDK

• Node.js Laufzeitumgebung

Lizenz

MIT