mirror of
https://github.com/angular/angular.git
synced 2026-09-14 13:54:52 +08:00
docs: update Angular MCP skill reference
(cherry picked from commit 789c9c242d)
This commit is contained in:
@@ -9,24 +9,15 @@ When the MCP server is enabled, AI agents have access to the following tools:
|
||||
| Name | Description |
|
||||
| :-------------------------- | :-------------------------------------------------------------------------------------------------------- |
|
||||
| `ai_tutor` | Launches an interactive AI-powered Angular tutor. |
|
||||
| `devserver.start` | Asynchronously starts a dev server (`ng serve`). Returns immediately. |
|
||||
| `devserver.stop` | Stops the dev server. |
|
||||
| `devserver.wait_for_build` | Returns the logs of the most recent build in a running dev server. |
|
||||
| `get_best_practices` | Retrieves the Angular Best Practices Guide (crucial for standalone components, typed forms, etc.). |
|
||||
| `list_projects` | Lists all applications and libraries in the workspace by reading `angular.json`. |
|
||||
| `onpush_zoneless_migration` | Analyzes code and provides a plan to migrate it to `OnPush` change detection (prerequisite for zoneless). |
|
||||
| `run_target` | Executes a configured target. |
|
||||
| `search_documentation` | Searches the official documentation at `https://angular.dev`. |
|
||||
|
||||
## Experimental Tools
|
||||
|
||||
Some tools must be enabled explicitly using the `--experimental-tool` (or `-E`) flag.
|
||||
|
||||
| Name | Description |
|
||||
| :------------------------- | :-------------------------------------------------------------------- |
|
||||
| `build` | Performs a one-off build using `ng build`. |
|
||||
| `devserver.start` | Asynchronously starts a dev server (`ng serve`). Returns immediately. |
|
||||
| `devserver.stop` | Stops the dev server. |
|
||||
| `devserver.wait_for_build` | Returns the logs of the most recent build in a running dev server. |
|
||||
| `e2e` | Executes end-to-end tests. |
|
||||
| `test` | Runs the project's unit tests. |
|
||||
|
||||
## Configuration
|
||||
|
||||
To use the MCP server, you configure your host environment (IDE or CLI) to run `npx @angular/cli mcp`.
|
||||
@@ -97,10 +88,9 @@ You can pass arguments to the MCP server in the `args` array of your configurati
|
||||
|
||||
- `--read-only`: Only registers tools that do not modify the project.
|
||||
- `--local-only`: Only registers tools that do not require an internet connection.
|
||||
- `--experimental-tool` (`-E`): Enables specific experimental tools (e.g., `-E build`, `-E devserver`).
|
||||
|
||||
Example for read-only mode with experimental tools enabled:
|
||||
Example for read-only mode:
|
||||
|
||||
```json
|
||||
"args": ["-y", "@angular/cli", "mcp", "--read-only", "-E", "build", "-E", "test"]
|
||||
"args": ["-y", "@angular/cli", "mcp", "--read-only"]
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user