内容
软件开发生命周期 MCP
一个最小的 Node + Express 网络应用程序，带有健康检查端点。在一小时内创建。
## 设置
1. 安装依赖：
```bash
npm install
```
2. 启动服务器：
```bash
npm start
```
3. 打开您的浏览器：
- 主页：http://localhost:3000
- 图片页：http://localhost:3000/pictures
- 健康检查：http://localhost:3000/health
## 测试
该项目支持使用 **Playwright** 和 **Vibium** 浏览器自动化框架进行测试。
### 运行测试
**运行所有测试（两个框架）：**
```bash
npm test
```
**仅运行 Playwright 测试：**
```bash
npm run test:playwright
```
**仅运行 Vibium 测试：**
```bash
npm run test:vibium
```
**依次运行两个框架：**
```bash
npm run test:all
```
### Playwright 的首次设置
如果在运行 Playwright 测试时遇到错误，您可能需要安装浏览器二进制文件：
```bash
npx playwright install
```
如果浏览器未安装，测试将自动显示有用的消息。
> **注意：** 在执行测试之前，服务器必须正在运行。使用单独的终端通过 `npm start` 启动它。
有关测试结构的更多详细信息，请参阅 [tests/README.md](tests/README.md)。
## 端点
- `GET /` - 带有导航和状态摘要的首页仪表盘
- `GET /pictures` - 带有上传表单的图像画廊
- `POST /pictures/upload` - 图片文件的上传端点
- `GET /health` - 健康检查端点（返回带有状态和时间戳的 JSON）
## MCP 服务器配置
该项目包含多个 MCP（模型上下文协议）服务器的配置。所有配置都位于 `.cursor/mcp.json` 中，以便于管理。
### 已配置的 MCP 服务器
1. **GitHub MCP 服务器**
- 包：`@protocol/server-github`
- 命令：`npx -y @modelcontextprotocol/server-github`
- 环境变量：`GITHUB_PERSONAL_ACCESS（必填 - 添加您的令牌）
2. **Playwright**
- 包：`@playwright/mcp@latest`
-`npx -y @playwright/mcp@latest`
- 提供浏览器自动化功能
3. **Vibium MCP 服务器**
- 包：`vibium`
命令：`npx -ium mcp`
-`stdio`
- 提供浏览器
### 设置说明
1. 配置文件（`.cursor/mcp.json`）已从版本控制中请参见 `.gitignore`它包含本地开发设置。
2. **适用于 GitHub MCP 服务器： - 使用适当的权限创建 GitHub 个人访问令牌
令牌添加到 `.cursor/mcp.json` 中的 `GITHUB_PERSONAL` 环境变量中
3. **在对 MCP 配置进行任何更改后，请重启 Cursor**，以使更改生效。
当使用支持 MCP 时，所有 MCP 服务器将自动可用。
