Skip to main content

RFS MCP Server(资源编排服务)

语言切换: English | 中文

版本

0.1.0

概述

华为云 RFS(Resource Formation Service,资源编排服务)的 MCP Server。让 MCP 客户端 通过场景化工具管理基础设施即代码:部署 HCL 模板为资源栈、执行计划干跑预览变更、 诊断失败部署、安全下线资源栈。

分类

管理与治理 / 基础设施即代码

功能

  • 部署 HCL 模板(内联文本或 OBS 地址)为 RFS 资源栈——自动创建或更新
  • 通过执行计划干跑模板变更(新增 / 删除 / 变更差异)
  • 诊断失败或卡住的栈:聚合状态、失败事件、失败资源、根因结论
  • 分页查询资源栈清单
  • 读取栈元数据与输出
  • 删除栈:显式确认流程 + 资源预览

工具清单

工具 场景 风险级别 API 文档
list_stacks 栈清单查询、按名称过滤 READ ListStacks
get_stack 栈元数据 + 输出值 READ GetStackMetadata / ListStackOutputs
preview_stack_changes 部署前干跑变更差异 READ CreateExecutionPlan / GetExecutionPlan
deploy_stack 从模板创建或更新栈 WRITE CreateStack / DeployStack
diagnose_stack 定位部署失败根因 READ ListStackEvents / ListStackResources
delete_stack 下线资源栈(需确认) DANGEROUS DeleteStack

使用指引

前置条件

  • Python 3.10+
  • UV

Linux/macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

配置

环境变量

变量 必填 说明 默认值
HUAWEICLOUD_ACCESS_KEY 是 账号 AK -
HUAWEICLOUD_SECRET_KEY 是 账号 SK -
HUAWEICLOUD_REGION 是 资源所在区域(如 cn-north-4) -
HUAWEICLOUD_PROJECT_ID 否 手动覆盖 project_id(默认经 IAM 自动解析) 自动解析
HUAWEICLOUD_SECURITY_TOKEN 否 STS 临时凭证 token -
HUAWEICLOUD_MCP_READ_ONLY 否 true 拦截所有 WRITE/DANGEROUS 工具 false
HUAWEICLOUD_MCP_PROTECTED_IDS 否 护栏:受保护资源 ID(逗号分隔,命中即 block) 空
HUAWEICLOUD_MCP_PROTECTED_NAMES 否 护栏:受保护资源名称(逗号分隔,命中即 block) 空
HUAWEICLOUD_MCP_PROTECTED_TAGS 否 护栏:受保护标签(逗号分隔 k 或 k=v) 空
HUAWEICLOUD_MCP_GUARDRAILS_CONFIG 否 复杂规则文件 guardrails.yaml 路径 空
HUAWEICLOUD_MCP_AUDIT_FILE 否 审计 JSONL 文件路径(审计始终开启,默认写 stderr) 空
MCP_SERVER_PORT 否 streamable-http 端口 8000
MCP_SERVER_HOST 否 streamable-http 绑定地址 0.0.0.0

护栏已知局限(参数级匹配): 保护规则匹配工具参数中的资源 ID、名称类参数、显式 传入的标签。仅在云侧打保护标签而参数中未出现的资源,由第二道防线兜底:delete_stack 在执行不可逆操作前会用栈的真实属性再次校验。

运行

方式一:以 stdio 协议运行(推荐本地使用)

由 Agent 直接拉起本地进程,无需手动启动服务。以 OpenCode 为例:

{
  "mcpServers": {
    "huaweicloud-rfs": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-huaweicloud-rfs@latest"
      ],
      "environment": {
        "HUAWEICLOUD_ACCESS_KEY": "",
        "HUAWEICLOUD_SECRET_KEY": "",
        "HUAWEICLOUD_REGION": "cn-north-4"
      }
    }
  }
}

将 HUAWEICLOUD_ACCESS_KEY、HUAWEICLOUD_SECRET_KEY 替换为实际值;生产环境建议锁定具体版本号,而非使用 @latest。

方式二:以 Streamable HTTP 服务方式运行

适用于远程部署或多客户端共享同一服务的场景。

  1. 获取代码并启动服务
git clone https://github.com/huaweicloud/huaweicloud-mcp.git
cd huaweicloud-mcp/server/mcp_huaweicloud_rfs
uv sync
uv run mcp-huaweicloud-rfs -t streamable-http   # 默认监听 8000 端口

服务启动后,MCP 端点地址为 http://127.0.0.1:8000/mcp。

  1. 在 Agent 中配置 MCP

以 OpenCode 为例:

{
  "mcpServers": {
    "huaweicloud-rfs": {
      "type": "remote",
      "url": "http://127.0.0.1:8000/mcp",
      "env": [
        "HUAWEICLOUD_ACCESS_KEY=xxxxx",
        "HUAWEICLOUD_SECRET_KEY=xxxxx",
        "HUAWEICLOUD_REGION=xxxxx"
      ]
    }
  }
}
  1. 验证

配置完成后重启 Agent,确认 MCP Server 处于已连接状态,并可正常调用 RFS 相关工具。

注意事项

  • 不同 Agent 的配置字段存在差异(例如 mcpServers / mcp、environment / env),具体请以对应 Agent 的官方文档为准。
  • 建议通过环境变量注入 AK/SK,避免将密钥明文写入配置文件并提交至代码仓库。
  • 选择建议:本地开发调试优先使用 stdio;需要远程访问或多客户端共享时使用 Streamable HTTP。

示例

Cursor / Claude Desktop / Trae

将上述 JSON 配置填入 MCP 客户端并填入凭证,然后自然语言使用:

  • "帮我把这个 HCL 模板部署成名为 web-app 的资源栈" → deploy_stack
  • "web-app 栈部署失败了,帮我看看原因" → diagnose_stack
  • "预览一下模板改动会影响哪些资源" → preview_stack_changes
  • "删掉 web-app 这个栈" → delete_stack(先返回预览,确认后执行)

许可证

MIT

Metadata

Release files for mcp-huaweicloud-rfs 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for mcp-huaweicloud-rfs 0.1.0
File Interpreter ABI Platform Actions
mcp_huaweicloud_rfs-0.1.0-py3-none-any.whl Python 3 none any Details for mcp_huaweicloud_rfs-0.1.0-py3-none-any.whl

Release files / mcp_huaweicloud_rfs-0.1.0-py3-none-any.whl

Download URL mcp_huaweicloud_rfs-0.1.0-py3-none-any.whl
Size 15.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9201f1519debe697f397a878f2b1ea96dffb3f09c670d37fef9bf29211d0d84f
BLAKE2b-256 checksum
How to use checksums
e7a5dff7a382fc11bcc4f41ba3232570be9d0ec61eef27e12302f4a4a10a8a57
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.22

Security for mcp-huaweicloud-rfs 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page