ALPS作家
](https://www.npmjs.com/package/alps-writer)
A. 模型上下文协议（MCP） 服务器，帮助您与AI交互编写ALPS（PRD）。通过模板、对话指南和文档管理引导您完成9个结构化部分。
特性
- 9节ALPS（PRD）模板，带结构化XML模板和对话指南
- 交互式问答工作流程——人工智能提出有针对性的问题，从不自动生成
- 文档管理——创建、保存、加载和导出为干净的Markdown
- 章节依赖性跟踪——确保首先审查引用的章节
- 适用于Claude Desktop、Claude Code、Cursor、Kiro和任何兼容MCP的客户端
快速开始
无需安装——只需将MCP配置添加到客户端即可：
{
"mcpServers": {
"alps-writer": {
"command": "npx",
"args": ["-y", "alps-writer"]
}
}
}客户端设置
| 客户端 | 配置位置 |
|---|---|
| 克劳德桌面版 | 设置>开发人员>编辑配置(claude_desktop_config.json) |
| 克劳德代码 | claude mcp add alps-writer -- npx -y alps-writer |
| 光标 | 设置>功能>MCP服务器>+添加新的全局MCP服务器 |
| 基罗 | Cmd+Shift+P >“Kiro:打开用户MCP配置（JSON）”(~/.kiro/settings/mcp.json) |
| Kiro命令行界面 | kiro-cli mcp add --name alps-writer --command npx --args "-y" --args "alps-writer" --scope global |
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
ALPS_OUTPUT_DIR | 文档文件目录(.alps.xml，出口降价） | /prd/ |
配置示例 ALPS_OUTPUT_DIR:
{
"mcpServers": {
"alps-writer": {
"command": "npx",
"args": ["-y", "alps-writer"],
"env": {
"ALPS_OUTPUT_DIR": "~/Documents/alps"
}
}
}
}可用工具
模板工具
| 工具 | 说明 |
|---|---|
get_alps_overview | 通过对话指南获取ALPS模板概述 |
list_alps_sections | 列出所有可用的模板部分 |
get_alps_section | 按数字（1-9）获取特定模板部分 |
get_alps_full_template | 获取包含所有部分的完整模板 |
get_alps_section_guide | 获取撰写章节的对话指南 |
文档管理工具
| 工具 | 说明 |
|---|---|
init_alps_document | 创建新的ALPS文档(.alps.xml) |
load_alps_document | 加载现有文档以继续编辑 |
save_alps_section | 将内容保存到特定子部分 |
read_alps_section | 阅读章节的当前内容 |
get_alps_document_status | 获取所有部分的状态 |
export_alps_markdown | 导出为干净的Markdown |
工作流程
服务器通过结构化的工作流程引导AI：
- 初始化 —
init_alps_document()或load_alps_document() - 概述 —
get_alps_overview()获取对话指南 - 对于每个部分（1-9）：
- get_alps_section_guide(N) --获取问题和标准 - get_alps_section(N) --获取模板结构 - 提出重点问题（一次1-2个） - save_alps_section(N, ...) --用户确认后保存
- 出口 —
export_alps_markdown()对于最终文件
ALPS部分
| # | 节 | 依赖关系 |
|---|---|---|
| 1 | 概述 | -- |
| 2 | MVP目标和关键指标 | -- |
| 3 | 演示场景 | 第2节 |
| 4 | 高层架构 | -- |
| 5 | 设计规范 | 第6节 |
| 6 | 需求汇总 | -- |
| 7 | 功能级别规范 | 第6节 |
| 8 | MVP指标 | 第2、6节 |
| 9 | 超出范围 | -- |
发展
从源头运行
git clone https://github.com/haandol/alps-writer-mcp.git
cd alps-writer-mcp
pnpm install
pnpm build然后配置您的MCP客户端：
{
"mcpServers": {
"alps-writer": {
"command": "node",
"args": ["/path/to/alps-writer-mcp/dist/index.js"]
}
}
}命令
pnpm install # Install dependencies
pnpm dev # Run with tsx (watch mode)
pnpm build # Build for production
pnpm start # Run built version许可证
麻省理工学院