PlugLayer MCP Server MCP 服务说明文档

发布时间:2026/8/25 13:32:57
PlugLayer MCP Server MCP 服务说明文档 1. 服务概述一句话简介通过自然语言部署和管理您的基础设施支持任何MCP兼容的AI助手服务名称PlugLayer MCP Server版本号最新版本开发者/提供方pluglayer协议类型MCP (Model Context Protocol)2. 核心功能PlugLayer MCP Server提供以下主要功能用户身份验证与角色管理通过Authentik提供用户身份和访问控制Docker镜像部署支持部署Docker镜像和Docker Compose应用到托管基础设施CI/CD集成生成GitHub Actions工作流实现自动化部署项目管理创建和管理项目命名空间计算节点管理添加和管理个人SSH计算节点自定义域名管理添加、验证和附加自定义域名到应用部署管理查看部署状态、日志、重新部署和回滚集群健康检查检查集群状态和运行状况3. 使用场景PlugLayer MCP Server适用于以下场景容器化应用部署快速部署Docker容器应用到生产环境基础设施管理通过自然语言管理云基础设施资源CI/CD流程自动化自动生成和配置GitHub Actions工作流多环境管理管理开发、测试和生产环境的项目和部署自定义域名配置为应用配置和管理自定义域名及DNS记录日志监控实时查看应用日志和运行状态4. 接入方式4.1 服务端点PlugLayer MCP Server支持以下运行方式本地运行通过uvx或pip安装本地运行远程HTTP服务托管服务运行在mcp.pluglayer.com4.2 认证与权限PlugLayer使用API密钥进行认证在PlugLayer设置页面创建PlugLayer API令牌使用PLUGLAYER_API_KEY环境变量传递令牌远程HTTP访问使用Bearer Token认证Authorization: Bearer your-pluglayer-api-token4.3 数据格式MCP服务与PlugLayer FastAPI后端通信所有数据通过JSON格式传输支持项目配置信息部署状态和日志计算节点信息域名DNS记录配置4.4 服务器配置在MCP客户端配置中添加服务{ mcpServers: { pluglayer: { command: uvx, args: [pluglayer-mcp], env: { PLUGLAYER_API_KEY: your-pluglayer-api-token, PLUGLAYER_API_BASE_URL: https://api.pluglayer.com } } } }5. 接口定义PlugLayer MCP Server提供丰富的工具接口工具名称功能描述get_current_user显示Authentik支持的用户和角色list_projects列出认证用户的项目create_project创建新项目命名空间deploy_image将Docker镜像部署到PlugLayer托管环境deploy_compose从docker-compose.yml部署应用list_deployments列出运行中的应用和部署get_deployment_status检查应用状态和URLget_logs获取应用日志redeploy重新部署应用rollback回滚到之前的版本add_custom_domain添加自定义域名并返回DNS记录generate_github_actions生成CI/CD流水线YAML配置get_cluster_health检查集群状态6. 快速开始6.1 环境要求Python 3.8或更高版本uvx或pip包管理器PlugLayer账户和API密钥MCP兼容的客户端如Claude Desktop、Cursor等6.2 示例代码安装方式一使用uvx推荐PLUGLAYER_API_KEYyour-pluglayer-api-token uvx pluglayer-mcp安装方式二使用pippip install pluglayer-mcp PLUGLAYER_API_KEYyour-pluglayer-api-token pluglayer-mcp使用示例对话# 部署应用 我有一个FastAPI应用在 ghcr.io/myorg/api:latest运行在8000端口。将其部署到我的production项目。 # 转换docker-compose 这是我的docker-compose.yml[粘贴内容]。将其部署到PlugLayer。 # 添加节点 将我的服务器192.168.1.100添加为个人计算节点。这是我的SSH密钥[粘贴密钥] # CI/CD设置 为我的api部署生成GitHub Actions工作流以便在推送到main分支时自动部署。7. 注意事项API密钥安全API密钥只在创建时显示一次请妥善保存认证方式MCP和编辑器插件应使用PlugLayer API令牌而非浏览器/会话认证令牌镜像仓库托管镜像仓库由PlugLayer管理员在平台UI/API中配置计算资源检查部署前会进行后端计算资源检查Kubernetes密钥同步使用镜像时后端会自动同步Kubernetes拉取密钥环境变量PLUGLAYER_API_BASE_URL是首选环境变量默认为https://api.pluglayer.com管理员功能部分管理员工具如admin_get_overview仅限管理员使用