b
build-deploy-mcp
whwace/build-deploy-mcp
0 Stars
10 次浏览
可乐啤酒鸭
更新于 2026-08-23
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"build-deploy-mcp": {
"args": [
"-y",
"build-deploy-mcp"
],
"command": "npx",
"env": {
"BUILD_OUTPUT_PATH": "dist",
"DEPLOY_SERVER_HOST": "127.0.0.1",
"DEPLOY_SERVER_PASSWORD": "your-password",
"DEPLOY_SERVER_PATH": "/var/www/html",
"DEPLOY_SERVER_PORT": "22",
"DEPLOY_SERVER_USER": "root",
"LOCAL_PROJECT_PATH": "/path/to/your/project"
}
}
}
}该服务需要配置环境变量：BUILD_OUTPUT_PATH、DEPLOY_SERVER_HOST、DEPLOY_SERVER_PASSWORD、DEPLOY_SERVER_PATH、DEPLOY_SERVER_PORT、DEPLOY_SERVER_USER、LOCAL_PROJECT_PATH
服务介绍
build-deploy-mcp
MCP (Model Context Protocol) 服务 - 在本地执行编译命令，然后将编译产物上传部署到远程服务器。
支持 智能命令匹配：AI 根据环境描述自动读取 package.json 的 scripts，匹配合适的构建命令。
- GitHub: https://github.com/whwBoy/build-deploy-mcp
- NPM: https://www.npmjs.com/package/build-deploy-mcp
安装
npm install -g build-deploy-mcp
环境变量配置
使用前需要设置以下环境变量：
| 变量名 | 必填 | 说明 |
|---|---|---|
DEPLOY_SERVER_HOST |
是 | 远程服务器主机地址 |
DEPLOY_SERVER_PORT |
否 | SSH 端口（默认 22） |
DEPLOY_SERVER_USER |
是 | SSH 登录用户名 |
DEPLOY_SERVER_PASSWORD |
是 | SSH 登录密码 |
DEPLOY_SERVER_PATH |
是 | 远程服务器部署路径 |
BUILD_OUTPUT_PATH |
是 | 编译输出路径（相对于项目根目录或绝对路径） |
LOCAL_PROJECT_PATH |
否 | 本地项目路径（默认当前工作目录） |
BUILD_COMMAND不再需要配置环境变量，由 AI 自动匹配或通过工具参数传入。
使用方式
作为 MCP 服务运行：
build-deploy-mcp
或配合 MCP 客户端配置文件（如 claude_desktop_config.json）：
{
"mcpServers": {
"build-deploy-mcp": {
"command": "npx",
"args": ["-y", "build-deploy-mcp"],
"env": {
"DEPLOY_SERVER_HOST": "127.0.0.1",
"DEPLOY_SERVER_PORT": "22",
"DEPLOY_SERVER_USER": "root",
"DEPLOY_SERVER_PASSWORD": "your-password",
"DEPLOY_SERVER_PATH": "/var/www/html",
"BUILD_OUTPUT_PATH": "dist",
"LOCAL_PROJECT_PATH": "/path/to/your/project"
}
}
}
}
提供的 MCP 工具
分步执行（AI Agent 逐步调用）
| 步骤 | 工具名称 | 功能 | 必填参数 |
|---|---|---|---|
| 辅助 | list_scripts |
查看目标项目的所有可用 scripts | 无 |
| ① | analyze_and_match |
分析项目 package.json 的 scripts，根据环境描述自动匹配构建命令 |
description |
| ② | run_build |
执行构建 | 无（使用上一步匹配结果） |
| ③ | deploy_to_server |
将构建产物通过 SFTP 部署到远程服务器 | 无（使用上一步配置） |
执行流程
analyze_and_match → run_build → deploy_to_server
使用示例
1. list_scripts → { "projectPath": "D:/my-project" }
2. analyze_and_match → { "description": "测试环境构建", "projectPath": "D:/my-project" }
3. run_build → {}
4. deploy_to_server → {}
智能匹配关键词
| 环境 | 支持的关键词 | 匹配优先级 |
|---|---|---|
| 生产环境 | prod, production, release, 生产, 正式, 线上 | build:prod > build:release > build |
| 测试环境 | test, testing, sit, uat, 测试 | build:test > build:sit > build |
| 预发布 | pre, staging, stage, 预发布, 灰度 | build:pre > build:staging > build |
| 开发环境 | dev, development, 开发 | build:dev > build |
许可证
ISC
