使用说明
🚀 谷歌VPS MCP
用于Google Cloud VPS管理的专业安全MCP服务器
部署•监控•管理 在人工智能的帮助下,您的谷歌云VPS
📖 目录
🎯 关于
谷歌VPS MCP 是专业级别 模型上下文协议(MCP)服务器 使AI助手能够管理您的 谷歌云VPS 实例安全高效。内置于 TypeScript 它专为生产使用而设计,与 ChatGPT, 克劳德桌面版,以及任何 MCP兼容AI工具.
🌟 主要特点
- 🖥️ 完成VPS设置 -具有安全强化、Node.js、PM2和防火墙规则的自动VPS配置
- 🚀 一键部署 -通过自动依赖安装和PM2配置直接从GitHub部署
- 📊 实时日志 -实时日志流、搜索功能和人工智能故障排除
- 🔐 安全环境 -通过验证、备份和屏蔽敏感值安全地管理.env文件
- 🤖 AI集成 -适用于ChatGPT、克劳德桌面、谷歌反重力、OpenCode和任何MCP客户端
- 🔒 企业安全 -命令验证、敏感数据屏蔽、审计日志记录和安全身份验证
🚀 你能做什么
非常适合想要:
- 将项目直接从GitHub部署到Google Cloud VPS
- 使用实时日志和实时指标监控应用程序
- 只需一个命令即可重新部署
- 安全地管理环境变量
- 在人工智能的帮助下解决问题
- 使用自然语言控制VPS实例
💼 用例
- 初创企业 -将web应用程序快速部署到Google Cloud
- 开发者 -无需手动SSH命令的自动VPS管理
- 开发运维 -人工智能辅助监控和故障排除
- 机构 -具有项目隔离的多客户端VPS管理
- 自由职业者 -专业的部署工作流程,设置最少
✨ 特征
| 🖥️ VPS设置 | 🚀 一键部署 | 📋 实时日志 |
|---|---|---|
| 自动VPS配置 | 立即从GitHub部署 | 实时日志流 |
| 包括安全强化 | PM2流程管理 | 搜索和过滤功能 |
| 预装Node.js和PM2 | 自定义构建命令 | 人工智能故障排除 |
| 🔐 环境管理 | 📊 监控 | 🔒 企业安全 |
|---|---|---|
| 安全.env文件处理 | CPU和内存跟踪 | 命令验证 |
| 更改前的备份 | 磁盘使用情况监控 | 敏感数据屏蔽 |
| 验证和净化 | 流程管理 | 审计日志 |
🔌 兼容性
Google VPS MCP可与任何支持 模型上下文协议(MCP):
| AI工具 | 状态 | 配置 |
|---|---|---|
| ChatGPT | ✅ 支持 | 指南 |
| 克劳德桌面版 | ✅ 支持 | 指南 |
| OpenCode | ✅ 支持 | MCP兼容 |
| 谷歌反重力 | ✅ 支持 | MCP兼容 |
| 其他MCP客户端 | ✅ 支持 | 标准MCP配置 |
⚡ 快速开始
起来,跑4步!
# 1️⃣ Clone the repository
git clone https://github.com/dannymaaz/google-vps-mcp.git
cd google-vps-mcp
# 2️⃣ Install dependencies
npm install
# 3️⃣ Build the project
npm run build
# 4️⃣ Authenticate with Google Cloud
gcloud auth application-default login
➡️ 查看完整文档
📦 安装
先决条件
确保已安装以下内容:
| 要求 | 版本 | 目的 |
|---|---|---|
| Node.js | >=18.0.0 | 运行时环境 |
| 谷歌云SDK | 最新 | GCP身份验证 |
| Git | 最新 | 版本控制 |
分步安装
# Clone the repository
git clone https://github.com/dannymaaz/google-vps-mcp.git
cd google-vps-mcp
# Install all dependencies
npm install
# Build the TypeScript code
npm run build
# Verify installation
npm run build
⚙️ 配置
🎯 自动项目选择器(新增!)
无需再手动输入项目ID!
谷歌VPS MCP现在包括 自动项目选择器 其中列出了您的所有Google Cloud项目:
# Run the interactive selector
npm run setup
这将:
- 列出您的所有Google Cloud项目
- 让您选择要使用的选项
- 自动配置两者
.env和反重力 - 你准备好了!
手动配置
如果您更喜欢手动设置:
# Option 1: User authentication (development)
gcloud auth application-default login
# Option 2: Service account (production)
gcloud auth activate-service-account --key-file=path/to/service-account.json
注: 您不需要在配置中设置项目ID。MCP将列出您的项目,您可以在创建资源时动态选择。
🛠️ 可用工具
VPS管理
| 工具 | 说明 |
|---|---|
vps_setup |
从头开始创建和配置新的VPS |
vps_status |
获取全面的VPS状态和指标 |
restart_service |
重新启动服务或应用程序 |
execute_command |
安全地运行经过验证的命令 |
部署
| 工具 | 说明 |
|---|---|
deploy_project |
使用完整配置从GitHub部署 |
redeploy |
拉取最新更改并重新启动应用程序 |
日志和监控
| 工具 | 说明 |
|---|---|
view_logs_live |
实时流式日志 |
search_logs |
使用过滤器搜索历史日志 |
troubleshoot_logs |
AI友好的日志分析和建议 |
环境
| 工具 | 说明 |
|---|---|
configure_env |
创建或更新.env文件 |
upload_env |
安全上传.env文件 |
get_env |
检索环境配置 |
🔌 AI集成设置
ChatGPT设置
- 安装与MCP兼容的ChatGPT客户端
- 添加以下配置:
{
"mcpServers": {
"google-vps": {
"command": "node",
"args": ["/path/to/google-vps-mcp/dist/index.js"],
"env": {}
}
}
}
Claude桌面设置
编辑 claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
窗户: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"google-vps": {
"command": "node",
"args": ["/absolute/path/to/google-vps-mcp/dist/index.js"],
"env": {}
}
}
}
🔒 安全
| 特性 | 描述 |
|---|---|
| 🛡️ 命令验证 | 自动阻止危险操作 |
| 🔐 Env口罩 | 隐藏敏感值(密码、密钥、令牌) |
| 📋 审计日志 | 记录所有操作以供审查 |
| 🔑 安全认证 | 使用官方Google Cloud库 |
受阻操作
出于安全考虑,以下内容将被自动阻止:
- ❌ 系统修改(
rm -rf /,chmod -R 777) - ❌ 特权升级尝试
- ❌ 服务中断命令
- ❌ 数据销毁操作
- ❌ 网络后门
📚 文档
🌐 查看完整文档
- 📖 完整的工具参考
- 🔧 详细的集成指南
- 🛠️ 故障排除指南
- ❓ 常见问题解答部分
可用于: 🇺🇸 英语|🇪🇸 西班牙语
👨💻 由...创建
丹尼·马兹
💖 支持
如果你觉得这个项目有帮助,可以考虑支持它的开发:
PayPal: paypal.me/Creativegt
Ko-fi: zh-cn.com/X8X71W99D6
📄 许可证
MIT许可证
版权所有©2024丹尼·马兹
特此免费向任何获得副本的人授予许可 本软件和相关文档文件(“软件”),以处理 在软件中不受限制,包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本。
🌟 如果你觉得这个仓库有用,就把它标上!
谷歌VPS MCP --使用AI进行专业VPS管理
