Cloud.ru容器应用程序MCP

用于与Cloud.ru容器应用程序和工件注册表交互的模型上下文协议（MCP）服务器。

什么是MCP？

模型上下文协议（MCP）是一个开放标准，可实现AI助手和外部工具或数据源之间的无缝集成。它允许AI模型以安全和可控的方式与您的应用程序、服务和数据进行交互。

使用MCP，您可以：

将AI助手的功能扩展到训练数据之外
实现与实时系统和API的实时交互
从您自己的数据源提供与上下文相关的信息
在不离开AI助手界面的情况下执行复杂的工作流程

示例用法

你可以简单地问你的人工智能助手，而不是手动执行任务：

"Build image, push and deploy to Cloud.ru Container Apps via MCP"

使用此MCP服务器，您的AI助手可以：

构建应用程序的Docker镜像
将其推送到Cloud.ru工件注册表
用新图像更新您的容器应用程序
报告部署状态

所有这些都是通过自然语言命令自动完成的，使每个人都可以访问复杂的DevOps任务。

将cloudru containerapps mcp安装到您的系统

go install github.com/Nick1994209/cloudru-containerapps-mcp/cmd/cloudru-containerapps-mcp@latest

或

go install ./cmd/cloudru-containerapps-mcp

docs/INSTALLATION.md

将cloudru containerapps mcp添加到您的IDE中。例如VisualStudioCode或游标

添加MCP设置

{
  "mcpServers": {
    "cloudru-containerapps-mcp": {
      "command": "cloudru-containerapps-mcp",
      "args": [],
      "env": {
        "CLOUDRU_KEY_ID": "********",
        "CLOUDRU_KEY_SECRET": "********",
        "CLOUDRU_PROJECT_ID": "********",
      },
      "timeout": 900,
      "disabledTools": []
    }
  }
}

docs/HOW_ADD_TO_IDE.md

服务器将在stdin/stdout上监听JSON-RPC消息。

MCP环境变量

docs/环境变量.md

函数

cloudru_containraps_description（）

返回此MCP的使用说明。

cloudru_docker_login（注册表名）

使用提供的凭据登录Cloud.ru Docker注册表。

参数：

registry_name：注册表名称（回退到CLOUDRU_registry_Name env var）

如果登录失败，您需要：

转到Cloud.ru进化工件注册表
创建注册表
获取访问密钥
参见文件：https://cloud.ru/docs/container-apps-evolution/ug/topics/tutorials\_\_before-work

cloudru_docker_build_and_push（注册表名、存储库名、图像版本、停靠文件路径、停靠文件目标、停靠文件文件夹、显示命令）

构建Docker镜像并将其推送到Cloud.ru工件注册表。

参数：

registry_name：注册表名称（回退到CLOUDRU_registry_Name env var）
repository_name：存储库的名称（回退到CLOUDRU_repository_Name env var，然后是当前目录名）
image_version：图像的版本/标签（可选，默认为“最新”）
dockerfile_path：Dockerfile的路径（可选，默认为“Dockerfile”）
dockerfile_target：多阶段Dockerfile中的目标阶段（可选，默认为“-”，表示没有目标）
dockerfile_folder：Dockerfile文件夹（构建上下文，默认为“.”，表示当前目录）
show_commands：如果为true，则返回Docker构建和推送命令而不执行它们（可选，默认为“true”）

如果Docker推送因身份验证问题而失败，并且设置了CLOUDRU_KEY_ID/CLOUDRU_KEY_SECRET环境变量，则该函数将尝试重新登录并重试推送操作。

cloudru_get_list_containraps（project_id）

从Cloud.ru获取容器应用程序的列表。项目ID可以通过CLOUDRU_Project_ID环境变量设置，并从console.Cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）

cloudru_get_containerapp（项目id，容器名称）

按名称从Cloud.ru获取特定的容器应用程序。项目ID可以通过CLOUDRU_Project_ID环境变量设置，并从console.cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：要检索的容器应用程序的名称

cloudru_create_containrapp（project_id、containerapp_name、containerapp_port、containerapp_image、containerapp_auto_deployments_enabled、containerapp.auto_deploymements_pattern、containerappprivileged、containerapp_id超时、containerapp_timeout、containerapp_cpu、containerapp_min_instance_count、containerapp_max_instance_account、containerappe_description、containerapp_Public_accessible、containerapp_protocol、containerapp_environment变量、containerapp_command、containerapp_adger）

在Cloud.ru中创建新的容器应用程序。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：要创建的容器应用程序的名称
containerapp_port：容器应用程序的端口号
containerapp_image：容器应用程序的图像
containerapp_auto_deployments_enabled：启用自动部署（可选，默认为“false”）
containerapp_auto_deployments_pattern：自动部署模式（可选，默认为“最新”）
containerapp_privileged：以特权模式运行容器（可选，默认为“false”）
containerapp_idle_timeout：容器空闲超时（可选，默认为“600秒”）
containerapp_timeout：请求超时（可选，默认为“60秒”）
containerapp_cpu：CPU分配（可选，默认为“0.1”，选项：0.1、0.2、0.5、1）
containerapp_min_instance_count：缩放的最小实例数（可选，默认为“0”）
containerapp_max_instance_count：可缩放的最大实例数（可选，默认为“1”）
containerapp_description：容器应用程序的描述（可选，默认为空字符串）
containerapp_publicly_accessible：容器应用程序是否可公开访问（可选，默认为“true”）
containerapp_protocol：容器应用程序的协议（可选，默认为“http_1”，选项：http_1、http_2）
containerapp_environment_variables：格式中的环境变量 =''；\='value2'（可选）
containerapp_command：在容器中运行的命令（逗号分隔值）（可选）
containerapp_args：命令的参数（逗号分隔值）（可选）

cloudru_patch_containrapp（项目id、containerapp_name、containerapp_port、containerapp_image、containerapp_auto_deployments_enabled、containerapp.auto_deploymements_pattern、containerapp_id超时、containerapp_timeout、containerapp_cpu、containerapp_min_instance_count、containerapp_max_instance_account、containerapp_description、containerapp_Public_access、containerapp_protocol、containerapp_environment变量、containerapp_command、containerapp_args）

修补Cloud.ru中现有的Container App。此函数获取当前状态，将其与新值合并，并更新容器应用程序。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：要修补的容器应用程序的名称
containerapp_port：容器应用程序的端口号（可选，如果没有提供，将保留现有端口号）
containerapp_image：容器应用程序的图像（可选，如果不提供，将保留现有图像）
containerapp_auto_deployments_enabled：启用自动部署（可选，如果不提供，将保留现有部署）
containerapp_auto_deployments_pattern：自动部署模式（可选，如果没有提供，将保留现有模式）
containerapp_idle_timeout：容器空闲超时（可选，如果没有提供，将保留现有）
containerapp_timeout：请求超时（可选，如果没有提供，将保留现有）
containerapp_cpu：CPU分配（可选，如果没有提供，将保留现有的）
containerapp_min_instance_count：用于扩展的最小实例数（可选，如果不提供，将保留现有实例）
containerapp_max_instance_count：可扩展的最大实例数（可选，如果不提供，将保留现有实例）
containerapp_description：容器应用程序的描述（可选，如果没有提供，将保留现有的）
containerapp_publicly_accessible：容器应用程序是否可公开访问（可选，如果不提供，将保留现有应用程序）
containerapp_protocol：容器应用程序的协议（可选，如果没有提供，将保留现有协议）
containerapp_environment_variables：格式中的环境变量 =''；\='value2'（可选，如果不提供，将保留现有值）
containerapp_command：在容器中运行的命令（逗号分隔值）（可选，如果未提供，将保留现有值）
containerapp_args：命令的参数（逗号分隔值）（可选，如果不提供，将保留现有值）

注： privileged 字段是只读的，不能通过此函数修改。

cloudru_delete_containerapp（项目id，容器名称）

从Cloud.ru中删除容器应用程序。警告：此操作无法撤消！

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：要删除的容器应用程序的名称

cloudru_start_containrapp（项目id，容器应用名称）

在Cloud.ru中启动容器应用程序。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：要启动的容器应用程序的名称

cloudru_stop_containrapp（项目id，容器应用名称）

停止Cloud.ru中的容器应用程序。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：要停止的容器应用程序的名称

cloudru_get_containerapp_logs（项目id，容器app_name）

按名称从Cloud.ru获取特定容器应用程序的日志。项目ID可以通过CLOUDRU_Project_ID环境变量设置，并从console.cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
containerapp_name：从中获取日志的容器应用程序的名称

cloudru_get_list_dockerregistries（project_id）

从Cloud.ru获取Docker注册表列表。项目ID可以通过CLOUDRU_Project_ID环境变量设置，也可以从console.Cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）

cloudru_create_docker_register（项目id、注册表名、注册表名公共）

在Cloud.ru中创建一个新的Docker注册表。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
registry_name：要创建的Docker注册表的名称
registry_is_public：布尔标志，指示注册表是公共（true）还是私有（false）

cloudru_get_register_images（注册表名）

从Cloud.ru中的Docker注册表获取映像列表。

参数：

registry_name：注册表名称（回退到CLOUDRU_registry_Name env var）

注意：此功能当前在main.go文件中已禁用（第56行已注释掉）。

cloudru_get_containerapp_system_logs（项目id，容器app_name）

按名称从Cloud.ru获取特定容器应用程序的系统日志。项目ID可以通过Project_ID环境变量设置，并从console.cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到Project_ID环境变量）
containerapp_name：从中获取系统日志的容器应用程序的名称

注意：此功能当前在main.go文件中已禁用（第53行已注释掉）。

cloudru_jobs_list（项目id，页面大小）

从Cloud.ru获取作业的分页列表。项目ID可以通过CLOUDRU_Project_ID环境变量设置，也可以从console.Cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
page_size：每页项目数（可选）

cloudru_create_job（项目id、作业名、作业图像、作业特权、作业pu、作业描述、作业环境变量、作业命令、作业参数、作业重试计数、作业执行超时、作业运行立即）

在Cloud.ru中创建新作业。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
job_name：要创建的作业的名称
job_image：工作图片
job_privileged：以特权模式运行容器（可选，默认为“false”）
job_cpu：CPU分配（可选，默认为“0.1”，选项：0.1、0.2、0.5、1）
job_description：作业描述（可选）
job_environment_variables：格式中的环境变量 =''；\='value2'（可选）
job_command：在容器中运行的命令（逗号分隔值）（可选）
job_args：命令的参数（逗号分隔值）（可选）
job_retry_count：重试次数（可选）
job_execution_timeout：执行超时（秒）（可选）
job_run_immediately：创建后立即运行作业（可选，默认为“false”）

cloudru_patch_job（项目id、作业名称、作业图像、作业优先级、作业配置、作业描述、作业环境变量、作业命令、作业参数、作业尝试计数、作业执行超时、作业运行立即）

修补Cloud.ru中的现有作业。此函数获取当前状态，将其与新值合并，并更新作业。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
job_name：要修补的作业的名称
job_image：作业图像（可选，如果未提供，将保留现有图像）
job_privileged：以特权模式运行容器（可选，如果没有提供，将保留现有容器）
job_cpu：CPU分配（可选，如果没有提供，将保留现有的）
job_description：工作描述（可选，如果没有提供，将保留现有内容）
job_environment_variables：格式中的环境变量 =''；\='value2'（可选，如果不提供，将保留现有值）
job_command：在容器中运行的命令（逗号分隔值）（可选，如果未提供，将保留现有值）
job_args：命令的参数（逗号分隔值）（可选，如果不提供，将保留现有值）
job_retry_count：重试次数（可选，如果不提供，将保留现有次数）
job_execution_timeout：执行超时时间（秒）（可选，如果没有提供，将保留现有时间）
job_run_immediately：修补后立即运行作业（可选，如果没有提供，将保留现有作业）

cloudru_execute-job（项目id、作业名称、参数）

按名称在Cloud.ru中执行作业。项目ID可以通过CLOUDRU_Project_ID环境变量设置，并从console.cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
job_name：要执行的作业的名称
params：带有作业执行参数的JSON字符串（可选）

cloudru_jobexecutions_list（项目id、作业名称、页面大小）

从Cloud.ru获取作业执行的分页列表。项目ID可以通过CLOUDRU_Project_ID环境变量设置，也可以从console.Cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
job_name：要执行的作业的名称
page_size：每页项目数（可选）

cloudru_get_hob（项目id，作业名称）

按名称从Cloud.ru获取特定作业。项目ID可以通过CLOUDRU_Project_ID环境变量设置，并从console.cloud.ru获取。

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
job_name：要检索的作业的名称

cloudru_delete_job（项目id，作业名称）

从Cloud.ru中删除作业。警告：此操作无法撤消！

参数：

project_id：Cloud.ru中的项目ID（回退到CLOUDRU_Project_ID环境变量）
job_name：要删除的作业的名称

当前禁用的功能

以下功能已实现，但目前在main.go文件中已禁用：

cloudru_get_containerapp_system_logs() -获取特定容器应用程序的系统日志（第53行已注释掉）
cloudru_get_registry_images() -从Docker注册表中获取映像列表（第56行已被注释掉）

要启用这些功能，请在中取消注释相应的注册行 cmd/cloudru-containerapps-mcp/main.go.

开发指南

在为这个项目做出贡献时，请遵循我们的 Git提交指南用于使用常规提交格式的英文一致提交消息。

文档

有关Cloud.ru容器应用程序的更多信息，请参阅： https://cloud.ru/docs/container-apps-evolution/ug/topics/tutorials\_\_before-work

cloudru containerapps MCP

快速接入

详细介绍