alibabacloud-agent-toolkit
starsforks
How to install alibabacloud-agent-toolkit?
aliyun/alibabacloud-agent-toolkit
$git clone https://github.com/aliyun/alibabacloud-agent-toolkitOfficial Alibaba Cloud MCP servers, skills, and plugins to help AI agents build on Alibaba Cloud
README.md
| 1 | # Alibaba Cloud Agent Toolkit |
| 2 | |
| 3 | [](LICENSE) |
| 4 | [](https://github.com/aliyun/alibabacloud-agent-toolkit/actions/workflows/build.yml) |
| 5 | [](#current-status) |
| 6 | |
| 7 | Help AI coding agents build, deploy, and operate applications on Alibaba Cloud. |
| 8 | |
| 9 | This repository provides Alibaba Cloud agent plugins, skills, MCP configuration, and validation tooling. |
| 10 | |
| 11 | ## Current Status |
| 12 | |
| 13 | The repository currently provides: |
| 14 | |
| 15 | - A top-level project scaffold for marketplace manifests, validation, CI, rules, and shared skills. |
| 16 | - Two active plugins: [`alibabacloud-core`](plugins/alibabacloud-core/) and [`alibabacloud-spec-ops`](plugins/alibabacloud-spec-ops/). |
| 17 | - Placeholder plugin directories for future agent and data analytics plugins. |
| 18 | |
| 19 | `alibabacloud-core` includes an SDK usage skill that generates Alibaba Cloud OpenAPI interaction code through a constrained MCP server. `alibabacloud-spec-ops` delivers a planning-to-execution workflow for Alibaba Cloud infrastructure operations driven by Terraform and IaC Service. |
| 20 | |
| 21 | ## Repository Layout |
| 22 | |
| 23 | ```text |
| 24 | . |
| 25 | ├── plugins/ |
| 26 | │ ├── alibabacloud-core/ |
| 27 | │ ├── alibabacloud-spec-ops/ |
| 28 | │ ├── alibabacloud-agent/ |
| 29 | │ └── alibabacloud-data-analytics/ |
| 30 | ├── rules/ |
| 31 | ├── skills/ |
| 32 | └── tools/ |
| 33 | ``` |
| 34 | |
| 35 | ### Hook Implementation Convention |
| 36 | |
| 37 | `alibabacloud-core` is the **canonical source of truth** for the hook |
| 38 | implementation. Hooks live at `plugins/alibabacloud-core/hooks/` as a real |
| 39 | directory (no symlinks). When a new plugin (e.g. `alibabacloud-agent`) |
| 40 | needs telemetry/tracing, copy the entire `plugins/alibabacloud-core/hooks/` |
| 41 | verbatim into the new plugin. **Do not maintain parallel implementations.** |
| 42 | CI (`tools/dev-hooks/verify-hooks.sh`) fails on any divergence or on the |
| 43 | re-introduction of a `hooks/` symlink. |
| 44 | |
| 45 | ## Plugins |
| 46 | |
| 47 | | Plugin | Status | Description | |
| 48 | |--------|--------|-------------| |
| 49 | | [alibabacloud-core](plugins/alibabacloud-core/) | Active | Alibaba Cloud OpenAPI SDK code generation using the local `alibabacloud-core` MCP server. | |
| 50 | | [alibabacloud-spec-ops](plugins/alibabacloud-spec-ops/) | Active | Spec-driven Alibaba Cloud infrastructure ops workflow: planning → Terraform codegen → validation → execution via IaC Service. | |
| 51 | | `alibabacloud-agent` | Placeholder | Reserved for future agent-focused capabilities. | |
| 52 | | `alibabacloud-data-analytics` | Placeholder | Reserved for future analytics and data workflow capabilities. | |
| 53 | |
| 54 | ## Prerequisites |
| 55 | |
| 56 | **Python 3.10+** — hook handlers (pre-installed on most systems). |
| 57 | |
| 58 | **[uv](https://docs.astral.sh/uv/)** (provides `uvx`) — telemetry tracing view & mcp server: |
| 59 | |
| 60 | ```bash |
| 61 | # macOS |
| 62 | brew install uv |
| 63 | ``` |
| 64 | |
| 65 | ``` |
| 66 | # Linux / WSL |
| 67 | curl -LsSf https://astral.sh/uv/install.sh | sh |
| 68 | source $HOME/.local/bin/env |
| 69 | ``` |
| 70 | |
| 71 | **[Alibaba Cloud CLI](https://help.aliyun.com/document_detail/139508.html)** (`aliyun`) — cloud operations: |
| 72 | |
| 73 | ```bash |
| 74 | # Linux amd64 |
| 75 | curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz | tar xz |
| 76 | |
| 77 | # macOS |
| 78 | brew install aliyun-cli |
| 79 | ``` |
| 80 | |
| 81 | ## Install Plugins |
| 82 | |
| 83 | ### One-command install (recommended) |
| 84 | |
| 85 | ```bash |
| 86 | npx openplugin aliyun/alibabacloud-agent-toolkit |
| 87 | ``` |
| 88 | |
| 89 | Automatically detects installed clients (Claude Code, Codex, QoderWork), lets you pick which plugins to install, and configures everything. |
| 90 | |
| 91 | ### Manual install |
| 92 | |
| 93 | #### Codex |
| 94 | |
| 95 | ```text |
| 96 | codex plugin marketplace add aliyun/alibabacloud-agent-toolkit |
| 97 | ``` |
| 98 | |
| 99 | Then open Codex `/plugins` and install `alibabacloud-core` and/or `alibabacloud-spec-ops`. |
| 100 | |
| 101 | #### Claude Code |
| 102 | |
| 103 | ```text |
| 104 | /plugin marketplace add aliyun/alibabacloud-agent-toolkit |
| 105 | /plugin install alibabacloud-core@alibabacloud-agent-toolkit |
| 106 | /plugin install alibabacloud-spec-ops@alibabacloud-agent-toolkit |
| 107 | /reload-plugins |
| 108 | ``` |
| 109 | |
| 110 | #### QoderWork |
| 111 | |
| 112 | Use the one-command install above (`npx openplugin`), which handles QoderWork hook registration automatically. |
| 113 | |
| 114 | The installer patches `~/.qoderwork/settings.json` with the same 4-event |
| 115 | hook set Codex uses (`PreToolUse`, `PostToolUse`, `UserPromptSubmit`, |
| 116 | `Stop`) and is idempotent — re-runs only refresh this plugin's entries. |
| 117 | |
| 118 | ## Use Spec-Ops: Spec-Driven Workflow |
| 119 | |
| 120 | Want an expert-guided, spec-driven flow that takes "I need a web app on aliyun" all the way to live infrastructure? One command: |
| 121 | |
| 122 | ```text |
| 123 | /alibabacloud-spec-ops:alibabacloud-planning I need a web app on aliyun |
| 124 | ``` |
| 125 | |
| 126 | 4 stages, auto-chained, **one user gate** (right before deploy): |
| 127 | |
| 128 | 1. **planning** — expert dialog across **Security / Cost / Efficiency / Stability**; turns vague needs into a precise `design.md` + architecture diagram |
| 129 | 2. **code** — Terraform HCL generated against live `alicloud_*` schemas (IaCService-verified) |
| 130 | 3. **validate** — spec + code-quality reviewers run in parallel → "deploy?" |
| 131 | 4. **execute** — `terraform plan` + `apply` run remotely via IaC Service; remote state persisted |
| 132 | |
| 133 | **Day-2 ready.** 再说一句"升配 RDS / 加 Redis / 缩容"，原 `design.md` 自动加载，在已有 ` |
People who liked this also viewed
6 picksType
- mcp-proxy-for-awsAWS MCP Proxy ServerMCP ServersJul 2026
- pydantic-ai-backendFile Storage & Sandbox Backends for Pydantic AI: console tools for file operations, Docker-isolated sandboxes for safe execution, and permission system with presets for access control. Enables secure multi-user handling and testing in agents via in-memory, local, or containerized storage.MCP ServersJul 2026
- mcp-for-argocdAn implementation of Model Context Protocol (MCP) server for Argo CD.MCP ServersJul 2026
- heroku-mcp-serverHeroku Platform MCP Server using the Heroku CLIMCP ServersJul 2026
- ghost-mcpA Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude. Allow you to control your Ghost blog by simply asking Claude etc.MCP ServersApr 2026
- Google DriveUpload, organize, and share files in the cloud. Manage folders, set permissions, and search across stored documents.MCP Serversrecently
