内容
# 🛠️ dv-mcp-prompts
[](#)
[](#)
[](#)
[](#)
*一款专为提高开发效率而设计的企业级模型上下文协议（MCP）服务器，能够为智能工作流直接提供高性能、结构化、上下文优化的提示信息。*
---
## 📖 核心概述与功能概览
### 技术执行摘要
现代开发环境越来越依赖于人工智能代理来搭建、审计和文档化复杂的代码库。然而，如果没有高度优化、结构化和上下文的提示信息，这些代理通常会产生通用、次优的样板代码。
`dv-mcp-prompts`是一款自定义的模型上下文协议（MCP）服务器，旨在弥补这一差距。通过注册一套专门的、高影响力的提示模板，它为开发者代理（如Cursor、VS Code或自定义MCP客户端）提供了精确的指令，以生成可直接投入生产的Next.js 15/React 19架构、完整的SEO技术审计、具有说服力的产品展示和详尽的系统文档。这消除了提示漂移，确保严格遵守软件工程标准，并强制执行高性能业务转换规则。
### 关键功能矩阵
| 图标 | 关键功能组件 | 核心业务或性能影响 |
| :---: | :--- | :--- |
| 🚀 | **自动化项目初始化** | 标准化Next.js 15设置，包括类型安全、依赖注入和本地代理管道脚本。 |
| 🛍️ | **电子商务架构生成** | 搭建垂直切片的Next.js 15电子商务系统，关注Web Vitals和弹簧动画。 |
| 🔍 | **技术SEO和SEM审计** | 通过代码级替换蓝图诊断水合冲击、布局偏移（CLS）和可爬取性瓶颈。 |
| 🖼️ | **具有说服力的产品展示** | 生成高转换率的展示页面，利用AIDA漏斗框架和响应式iframe预览抽屉。 |
| 📄 | **详尽的README生成** | 自动编写技术性、结构化和视觉上吸引人的文档，适用于任何代码库领域。 |
| 🗺️ | **程序化元数据和爬取** | 制定动态SEO结构，包括Open Graph CTR画布、`robots.ts`和异步`sitemap.ts`。 |
---
## 🚀 架构运行时流程
当代理客户端通过标准输入/输出（STDIO）传输连接到`dv-mcp-prompts`时，交互遵循确定的顺序：
```mermaid
graph TD
A[代理客户端，例如Cursor / VS Code] -->|1. 列表提示请求| B(Stdio服务器传输)
B --> C{MCP服务器}
C -->|2. 返回可用提示模式| A
A -->|3. 获取提示请求及参数| B
B --> C
C -->|4. 解析提示模板和注入参数| D[MIS_PROMPTS注册表]
D -->|5. 返回注入的提示文本| B
B -->|6. 将提示渲染到用户/代理聊天上下文| A
```
1. **协议握手和发现：** 客户端启动stdio传输握手并调用`ListPromptsRequestSchema`处理程序。服务器回复所有注册提示的列表（`MIS_PROMPTS`），包括其所需/可选参数的详细信息和描述。
2. **参数注入和渲染：** 当用户或代理调用特定提示（例如，`/mcp:dv-prompts:readme-generator`）时，客户端触发`GetPromptRequestSchema`，传递参数。服务器处理模板，动态注入参数，并返回完全渲染的Markdown提示。
---
## 📁 注释目录树
```
dv-mcp-prompts/
├── .gitignore # 排除node_modules、编译资产和环境文件。
├── dist/ # 编译后的生产就绪JavaScript代码（通过tsc生成）。
├── mcp_config.json # 在IDE设置中注册本地MCP服务器的配置文件。
├── package.json # 核心依赖项清单、脚本定义和元数据。
├── tsconfig.json # 严格的TypeScript编译器选项和构建输出配置。
└── src/ # 核心服务器源代码。
├── server.ts # 启动MCP服务器，声明功能并注册模式处理程序。
└── prompts/ # 模块化提示目录（高度内聚的提示模板定义）。
├── cabuwebDetail.ts # 具有说服力、关注转换的产品展示页面生成提示。
├── createEcommerce.ts # 完整的电子商务垂直切片架构搭建提示。
├── createProject.ts # Next.js 15干净的搭建和代理脚本管道提示。
├── readmeGenerator.ts # 详尽的README.md生成提示。
├── seoPageArchitecture.ts # 技术SEO元数据、Open Graph资产和站点地图生成提示。
└── seoSemAudit.ts # 高级核心Web Vitals、索引和水合冲击审计提示。
```
---
## 🛠️ 技术栈和依赖层
### 生产依赖项
| 图标 | 核心技术/库 | 严格的语义版本 | 明确的项目用途 |
| :---: | :--- | :---: | :--- |
| 🛡️ | `@modelcontextprotocol/sdk` | `^1.29.0` | 启用标准MCP服务器连接、STDIO传输管理和提示路由。 |
### 开发/构建工具依赖项
| 图标 | 核心技术/库 | 严格的语义版本 | 明确的项目用途 |
| :---: | :--- | :---: | :--- |
| 📘 | `typescript` | `^7.0.2` | 实现类型安全代码编译和编译检查。 |
| 🟢 | `@types/node` | `^26.1.1` | 为编译提供Node.js环境类型签名。 |
---
## ⚙️ 配置和基础设施执行指南
### 先决条件
- **Node.js:** `>= 20.0.0`（推荐）
- **NPM:** `>= 10.0.0`
### 可执行代码块
#### 1. 仓库克隆
```bash
git clone https://github.com/DiegoVilla27/dv-mcp-prompts.git
cd dv-mcp-prompts
```
#### 2. 依赖项安装
```bash
npm install
```
#### 3. 编译和构建
```bash
npm run build
```
#### 4. 本地开发执行
在stdio传输模式下，在本地启动MCP服务器：
```bash
npm start
```
#### 5. 与Cursor / VS Code集成
要将此服务器与您喜欢的AI驱动的编辑器集成，请在全局MCP设置中添加以下配置（例如，在Cursor的*设置 > 功能 > MCP*下）：
```json
{
"mcpServers": {
"dv-prompts": {
"command": "node",
"args": ["/绝对路径/to/dv-mcp-prompts/dist/server.js"]
}
}
}
```
---
## 📈 核心Web Vitals / 架构弹性
作为使用标准I/O（stdio）上的模型上下文协议的纯Node.js命令行应用程序，`dv-mcp-prompts`在提示生成期间保持零网络运行时占用。
- **错误边界：** 服务器在`GetPromptRequestSchema`请求处理程序中实现了强大的try-catch机制，以捕获未知的提示名称，并报告用户友好的错误，而不会使主STDIO流进程崩溃。
- **微性能：** 提示模板被构造为纯JavaScript/TypeScript函数，以确保微秒级编译和提示文本的传递。
---
## 🤝 贡献界限和许可证
1. **复刻仓库** 并创建功能分支：`git checkout -b feature/amazing-prompt`。
2. **遵守`src/prompts/`中找到的模板结构。** 每个提示必须导出一个符合MCP提示模式的内聚配置对象。
3. **通过`npm run build`运行构建验证** 以保证零编译错误。
4. **提交拉取请求**，将您的更改明确映射到未完成的议题。
在**ISC许可证**下分发。有关详细信息，请参见`package.json`。
---
## ✒️ 作者和致谢
> 这个数字生态系统是由 **[Cabuweb](https://cabuweb.com)** 设计、构建和开发到高性能标准的。
