Huawei RocketMQ MCP
Provides read-only troubleshooting tools for Huawei Cloud RocketMQ, including querying instances, topics, consumer groups, consumer connections, broker/node configuration, and backlog status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Huawei RocketMQ MCP check the message backlog for my consumer group on RocketMQ instance in cn-north-4"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Huawei RocketMQ Skill + MCP
独立的华为云 RocketMQ 只读排障工具,提供 Agent Skill、轻量 Python stdio MCP 服务,以及 Cursor、Claude Code、OpenCode、Codex 的安装/卸载脚本。
这是 key-well 维护的社区项目,非华为云官方发布。复用 LTS 项目的安装和适配实现,工具绑定使用华为云官方 Python SDK,无需克隆整套上游 MCP 工程。来源与许可证见 NOTICE。
能力
华为云 RocketMQ 实例、Topic、消费组、消费者连接和积压排查,共 20 个只读查询工具。完整清单见 references/tools.md。
不提供消息正文、用户密钥、发送/消费消息、重置消费进度、重试/补发、Topic 变更、实例重启或 ACL 修改。
Related MCP server: sangfor-mcp-server
安装
要求 macOS/Linux、Git、Python 3.10+、uv 和至少一个受支持客户端。
git clone https://github.com/key-well/huawei-rocketmq-skill.git
cd huawei-rocketmq-skill
./install.sh --platforms codex
# 可选:cursor / claude / opencode,逗号分隔;不指定则安装所有客户端
# ./install.sh --platforms cursor,claude
# 自定义运行目录必须为绝对路径或 ~/ 开头
# ./install.sh --platforms codex --install-dir ~/tools/huawei-rocketmq-skill默认运行目录:~/.local/share/huawei-rocketmq-skill。安装在独立 .venv 中运行,合并本服务的 MCP 项并备份已有客户端配置;不同服务分别安装,不覆盖其他 MCP 项。不会调用 sudo,也不会自动安装 uv。
客户端 | Skill 目录 | MCP 配置 |
Codex |
|
|
Claude Code |
|
|
Cursor |
|
|
OpenCode |
|
|
安装后,在本地配置里将下列占位符替换为自己的值,再重启客户端。不要把真实 AK/SK 发到聊天或提交到仓库。
HUAWEI_ACCESS_KEY=REPLACE_WITH_YOUR_AK
HUAWEI_SECRET_KEY=REPLACE_WITH_YOUR_SK
HUAWEI_REGION=REPLACE_WITH_YOUR_REGION
HUAWEI_PROJECT_ID=REPLACE_WITH_YOUR_PROJECT_ID地域/项目也可由工具调用 region / project_id 覆盖,优先级高于环境默认值。运行时要求二者完整,不自动跨项目查询。此版本不支持 STS 临时凭证。
建议使用专用、最小只读 IAM 权限;工具白名单限制不替代云端权限管理。安装脚本重复执行会重写本服务的 MCP 项为占位配置,请妥善保留自己的本地配置并重新填入,不要将配置备份提交 Git。
使用
列出指定项目的 RocketMQ 实例并核对运行状态。
排查实例 INSTANCE_ID 的消费组 GROUP_NAME 积压,检查消费者连接和 Topic 状态。
检查实例 INSTANCE_ID 的 Broker、节点和已有配置,不拉取业务消息。
Skill 中包含服务专属的排查路线和数据边界。CES 监控或 LTS 日志跨服务关联需要分别安装相应 MCP,不会自动连接。
卸载
./uninstall.sh --platforms codex
# 自定义运行目录时传入与安装时一致的 --install-dir仅卸载本安装拥有的配置和 Skill,恢复安装前记录的条目;仍有客户端使用时保留运行目录。先前配置备份可能含有本地凭证,请自行安全保管。
开发与验证
uv sync --frozen --extra dev
uv run pytest
uv run python scripts/generate_tools.py --check
bash -n install.sh uninstall.shreferences/operations.json 是显式工具白名单;生成脚本验证 SDK 请求类、方法和 HTTP 方式,并生成已提交的完整 inputSchema。升级依赖后运行 --write 更新目录,并审查差异。拒绝未登记操作、未知字段、缺失必填字段和类型不匹配的请求。
测试使用假客户端和临时 HOME,不需要云凭证,不会更改真实客户端配置。包含安装/卸载、参数转换、版本路由及 stdio 协议检查。离线测试通过不等于云端验收通过;首次使用仍需以自己的只读账号验证地域、权限与实际返回字段。
许可证
主体代码 MIT;保留 LTS 上游版权声明。官方操作清单衍生部分遵守 Apache-2.0,详见 NOTICE、LTS-LICENSE 和 licenses/iaas-mcp-server-LICENSE。
Available Tools
20 toolsListAvailableZonesListAvailableZonesCRead-onlyIdempotent
查询可用区信息(只读查询)
Inputs: region, project_id.
ListBrokersListBrokersCRead-onlyIdempotent
查询代理列表(只读查询)
Inputs: instance_id (required), limit, offset, region, +1 more.
ListConsumeGroupAccessPolicyListConsumeGroupAccessPolicyCRead-onlyIdempotent
查询消费组的授权用户列表(只读查询)
Inputs: group (required), engine (required), instance_id (required), limit, +3 more.
ListConsumerGroupOfTopicListConsumerGroupOfTopicCRead-onlyIdempotent
查询主题消费组列表(只读查询)
Inputs: topic (required), instance_id (required), limit, offset, +2 more.
ListEngineProductsListEngineProductsCRead-onlyIdempotent
查询产品规格列表(只读查询)
Inputs: engine (required), type, limit, offset, +3 more.
ListInstanceConsumerGroupsListInstanceConsumerGroupsCRead-onlyIdempotent
查询消费组列表(只读查询)
Inputs: instance_id (required), group, limit, offset, +2 more.
ListInstancesListInstancesCRead-onlyIdempotent
查询所有实例列表(只读查询)
Inputs: engine (required), name, limit, offset, +7 more.
ListRocketInstanceTopicsListRocketInstanceTopicsCRead-onlyIdempotent
查询主题列表(只读查询)
Inputs: instance_id (required), limit, offset, region, +1 more.
ListRocketMqMigrationTaskListRocketMqMigrationTaskBRead-onlyIdempotent
查询实例下所有迁移任务或查询指定迁移任务信息(只读查询)
Inputs: instance_id (required), id, name, type, +4 more.
ListTopicAccessPolicyListTopicAccessPolicyCRead-onlyIdempotent
查询主题的授权用户列表(只读查询)
Inputs: topic (required), instance_id (required), limit, offset, +2 more.
ShowConsumerConnectionsShowConsumerConnectionsCRead-onlyIdempotent
查询消费者列表(只读查询)
Inputs: group (required), instance_id (required), limit, offset, +3 more.
ShowConsumerListOrDetailsShowConsumerListOrDetailsCRead-onlyIdempotent
查询消费列表或详情(只读查询)
Inputs: group (required), instance_id (required), limit, topic, +3 more.
ShowGroupShowGroupCRead-onlyIdempotent
查询指定消费组(只读查询)
Inputs: group (required), instance_id (required), region, project_id.
ShowInstanceShowInstanceCRead-onlyIdempotent
查询指定实例(只读查询)
Inputs: instance_id (required), region, project_id.
ShowInstanceNodesShowInstanceNodesCRead-onlyIdempotent
查询实例节点(只读查询)
Inputs: engine (required), instance_id (required), limit, offset, +2 more.
ShowOneTopicShowOneTopicCRead-onlyIdempotent
查询单个主题(只读查询)
Inputs: topic (required), instance_id (required), region, project_id.
ShowRocketMqConfigsShowRocketMqConfigsCRead-onlyIdempotent
查询RocketMQ配置(只读查询)
Inputs: instance_id (required), limit, offset, region, +1 more.
ShowRocketmqProjectTagsShowRocketmqProjectTagsCRead-onlyIdempotent
查询项目标签(只读查询)
Inputs: limit, offset, region, project_id.
ShowRocketmqTagsShowRocketmqTagsCRead-onlyIdempotent
查询实例标签(只读查询)
Inputs: instance_id (required), limit, offset, region, +1 more.
ShowTopicStatusShowTopicStatusCRead-onlyIdempotent
查询主题的消息数(只读查询)
Inputs: topic (required), instance_id (required), region, project_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Most tools target a distinct resource, but the consumer-group surface is crowded: ListInstanceConsumerGroups, ListConsumerGroupOfTopic, ShowGroup, ShowConsumerListOrDetails and ShowConsumerConnections overlap in scope and could be misselected. Tag tools (ShowRocketmqTags vs ShowRocketmqProjectTags) and instance tools (ShowInstance vs ShowInstanceNodes) are also easily confused.
A clear Show*/List* verb prefix convention is used throughout, which is predictable and readable. Minor inconsistency only in casing of the product token (RocketMQ/RocketMq/Rocketmq) and the vague 'ShowConsumerListOrDetails' name.
20 tools is on the heavy side of the acceptable band and reflects a one-to-one wrapping of cloud API endpoints rather than a curated surface. It is not excessive for the domain, but a few read variants could be consolidated.
The entire surface is read-only: no create/update/delete for instances, topics, consumer groups, or access policies, and no message send/consume or reset-offset operations. For a RocketMQ management server this leaves major lifecycle workflows unreachable, forcing agents to fail on common administrative tasks.
Maintenance
Related MCP Connectors
Read-only access to a Lumin project's logs, metrics, uptime checks, alerts and infrastructure.
Read-only access to your Infrly services, deploys, logs, metrics and billing.
Read-only Search Console analytics, URL inspection, indexing diagnostics, and sitemaps.
Read-only access to your CloudFix AWS cost-saving recommendations, reports and EC2 pricing.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables read-only inspection of Google Ads accounts through MCP, including account inventory, reporting, metadata, change history, and safe GAQL queries.Apache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables read-only inspection of Sangfor HCI/SCP clusters, covering VMs, nodes, storage, networking, snapshots, images, and metrics through MCP tools.-
- FlicenseNot gradedqualityDmaintenanceProvides read-only multi-account access to Alibaba Cloud services, enabling secure queries of ECS, VPC, tags, bills, monitoring alerts, ActionTrail events, and SLS logs via stdio or HTTP.-
- AlicenseNot gradedqualityCmaintenanceEnables users to inspect databases through read-only tools that explain queries, sample rows, and list indexes, while refusing apply or delete operations.MIT