prompts-mcp-server
一个通用的 MCP (Model Context Protocol) Server，可自动为任意软件项目生成和管理 prompts 系统，使 AI 编程助手能够在开发会话间保持持久化上下文。
功能特性
- 智能项目扫描 — 自动识别目标项目的技术栈、框架、数据库和构建工具
- 上下文持久化 — 维护项目上下文、对话记录、模块变更历史的完整链路
- 需求澄清检查 — 基于 5 项标准的需求确认机制，避免盲目开发
- 计划生成 — 需求确认后生成可执行计划，等待用户确认后再实施
- 滚动窗口系统 — 维护最近 5 条对话记录和 10 条状态摘要，自动轮转
- 模块级追踪 — 按功能模块记录变更历史，便于追溯
- 双接口模式 — 支持 MCP Server（stdio 协议）和 CLI 两种使用方式
- 非破坏性初始化 — 生成 prompts 文件时不会覆盖已有文件
MCP 工具
| 工具 | 说明 |
|---|---|
init_prompts | 扫描目标项目并自动生成 prompts 文件体系 |
bootstrap | 一键加载所有上下文文件，AI 代理启动时第一步调用 |
check_requirements | 5 项标准需求澄清检查（目标、输入输出、约束、验收标准、影响范围） |
make_plan | 需求澄清通过后生成可执行计划 |
log_dialog | 记录对话条目到传输链路（滚动窗口 + 状态摘要） |
log_module | 记录模块级变更（目录式管理） |
read_module | 读取模块变更历史 |
update_todos | 更新 TODO 列表（添加/完成/移除） |
安装
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
环境变量
| 变量 | 说明 | 默认值 |
|---|---|---|
PROJECT_ROOT | 目标项目根目录 | process.cwd() |
生成的文件结构
初始化后会在目标项目的 .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 运行时
许可证
MIT