prompts-mcp-server
prompts-mcp-server
一个通用的 MCP (Model Context Protocol) Server,可自动为任意软件项目生成和管理 prompts 系统,使 AI 编程助手能够在开发会话间保持持久化上下文。
功能特性
智能项目扫描 — 自动识别目标项目的技术栈、框架、数据库和构建工具
上下文持久化 — 维护项目上下文、对话记录、模块变更历史的完整链路
需求澄清检查 — 基于 5 项标准的需求确认机制,避免盲目开发
计划生成 — 需求确认后生成可执行计划,等待用户确认后再实施
滚动窗口系统 — 维护最近 5 条对话记录和 10 条状态摘要,自动轮转
模块级追踪 — 按功能模块记录变更历史,便于追溯
双接口模式 — 支持 MCP Server(stdio 协议)和 CLI 两种使用方式
非破坏性初始化 — 生成 prompts 文件时不会覆盖已有文件
MCP 工具
工具 | 说明 |
| 扫描目标项目并自动生成 prompts 文件体系 |
| 一键加载所有上下文文件,AI 代理启动时第一步调用 |
| 5 项标准需求澄清检查(目标、输入输出、约束、验收标准、影响范围) |
| 需求澄清通过后生成可执行计划 |
| 记录对话条目到传输链路(滚动窗口 + 状态摘要) |
| 记录模块级变更(目录式管理) |
| 读取模块变更历史 |
| 更新 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环境变量
变量 | 说明 | 默认值 |
| 目标项目根目录 |
|
生成的文件结构
初始化后会在目标项目的 .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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/thana0623/prompts-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server