# 🚀 SQLx MCP Server CI/CD Pipeline
完整的 GitHub Actions + NPM 发布流水线已成功配置！
## 📋 已配置的功能
### 🔄 自动化流水线
- **GitHub Actions**: 自动构建、测试、发布
- **多平台构建**: Windows x64, Linux x64, macOS x64/ARM64
- **NPM 发布**: `@sqlx-mcp` 命名空间下的包
- **GitHub Releases**: 带二进制文件的发布版本
### 📦 NPM 包结构
- **主包**: `@sqlx-mcp/sqlx-mcp` - 主入口包
- **平台包**:
- `@sqlx-mcp/windows-x64`
- `@sqlx-mcp/linux-x64`
- `@sqlx-mcp/macos-x64`
- `@sqlx-mcp/macos-arm64`
### 🛠️ 本地开发工具
- **Node.js 构建脚本**: `node scripts/build.js`
- **PowerShell 包装器**: `.\build.ps1`
- **跨平台编译**: 支持所有目标平台
## 🚀 发布方式
### 方式 1: 标签发布 (推荐)
```bash
git tag v1.0.2
git push origin v1.0.2
```
### 方式 2: 手动发布
```bash
gh workflow run "Release and Publish" --field version=1.0.2
```
## 📚 用户安装方式
### NPM 全局安装 (推荐)
```bash
npm install -g @sqlx-mcp/sqlx-mcp
sqlx-mcp --database-url "postgresql://user:pass@localhost/mydb"
```
### 下载二进制文件
从 [GitHub Releases](https://github.com/lihongjie0209/sqlx-mcp/releases) 下载对应平台的二进制文件
### Claude Desktop 集成
```json
{
"mcpServers": {
"sqlx-mcp": {
"command": "sqlx-mcp",
"args": ["--database-url", "your-database-url"]
}
}
}
```
## 🔧 所需配置
### GitHub Secrets
为了启用 NPM 发布，需要在 GitHub 仓库设置中添加：
- `NPM_TOKEN`: NPM 访问令牌 (需要发布权限)
### NPM 令牌创建
1. 登录 [npmjs.com](https://www.npmjs.com)
2. 转到 Settings → Access Tokens
3. 创建 "Automation" 类型的令牌
4. 在 GitHub 仓库的 Settings → Secrets 中添加 `NPM_TOKEN`
## 📋 工作流程
1. **构建阶段**:
- 为所有平台交叉编译 Rust 二进制文件
- 运行测试和代码质量检查
- 创建构建产物
2. **NPM 发布阶段**:
- 创建平台特定的 NPM 包
- 发布到 @sqlx-mcp 命名空间
- 等待平台包可用
- 发布主包
3. **GitHub 发布阶段**:
- 创建发布压缩包
- 生成发布说明
- 上传二进制文件
## 🎯 当前状态
✅ **已完成**:
- ✅ CI/CD 流水线配置 (已修复)
- ✅ 多平台构建系统 (Windows, Linux, macOS x64/ARM64)
- ✅ NPM 包结构设计 (@sqlx-mcp 命名空间)
- ✅ 本地开发工具 (build.js, build.ps1)
- ✅ 完整文档套件
- ✅ 流水线问题修复
🔧 **修复的问题**:
- 分支名称: main/develop → master
- 包名称: @svg-mcp → @sqlx-mcp
- 发布说明: SVG MCP → SQLx MCP
- NPM 脚本: 完整重写适配 SQLx MCP
- 主包创建: 动态生成而非依赖现有 package.json
⏳ **待配置**:
- NPM_TOKEN 密钥 (需要手动添加到 GitHub Secrets)
- 首次发布测试
🚀 **下一步**:
1. 添加 NPM_TOKEN 到 GitHub Secrets
2. 创建版本标签触发首次发布
3. 验证 NPM 包安装和功能
## 📞 支持
- [工作流配置](.github/workflows/release.yml)
- [部署指南](DEPLOYMENT_GUIDE.md)
- [NPM 使用指南](NPM_USAGE.md)
- [GitHub 仓库](https://github.com/lihongjie0209/sqlx-mcp)
---
🎉 **SQLx MCP Server 现在具备了完整的 CI/CD 能力！**
