-
Notifications
You must be signed in to change notification settings - Fork 855
Update the aspire skill to use the CLI instead of the MCP server #14619
Copy link
Copy link
Closed
Description
Summary
The current Aspire skill (SKILL.md) generated by aspire agent init instructs agents to use the Aspire MCP server tools (e.g., list_resources, list_structured_logs, search_docs) for interacting with running Aspire applications. Now that the Aspire CLI has full parity with these MCP tools via CLI commands, the skill should be updated to instruct agents to use the CLI commands instead.
This removes the dependency on the MCP server being configured and running, making the skill work in any environment where the aspire CLI is installed.
Current State
The skill file at src/Aspire.Cli/Agents/CommonAgentApplicators.cs contains SkillFileContent that references MCP tools throughout:
- "Use Aspire MCP tools (list_resources, list_integrations, list_structured_logs, get_doc, search_docs)"
- "use the list resources tool"
- "use the list structured logs tool"
- "use the list traces tool"
- etc.
MCP Tool → CLI Command Mapping
Every MCP tool has a CLI equivalent:
| MCP Tool | CLI Command |
|---|---|
list_resources |
aspire resources [<resource>] |
execute_resource_command |
aspire command <resource> <command> |
| resource start/stop/restart | aspire start <resource> / aspire stop <resource> / aspire restart <resource> |
list_integrations + get_integration_docs |
aspire add (interactive list) |
list_structured_logs |
aspire telemetry logs [<resource>] |
list_console_logs |
aspire logs [<resource>] |
list_traces |
aspire telemetry traces [<resource>] |
list_trace_structured_logs |
aspire telemetry logs --trace-id <id> |
select_apphost |
--project <path> flag on all commands |
list_apphosts |
aspire ps |
list_docs |
aspire docs list |
search_docs |
aspire docs search <query> |
get_doc |
aspire docs get <slug> |
doctor |
aspire doctor |
What Needs to Change
- Update
SkillFileContentinCommonAgentApplicators.cs— replace all references to MCP tools with their CLI command equivalents. - Update the skill description — remove "Aspire MCP tools" references and replace with CLI commands.
- Update the debugging section — replace tool references like
_list structured logs_withaspire telemetry logs, etc. - Update the documentation section — replace
list_docs/search_docs/get_docMCP tool references withaspire docs list/aspire docs search/aspire docs get. - Update the "Checking resources" section — replace
_list resources_ tool/_execute resource command_ toolwithaspire resources/aspire command. - Update the "Other Aspire MCP tools" section — replace with CLI equivalents (
aspire ps,--projectflag). - Consider removing the Playwright MCP section or keeping it as-is (it's unrelated to Aspire MCP).
Benefits
- No MCP server dependency — the skill works with just the CLI installed
- Works in all agent environments — CLI commands work everywhere (VS Code, Copilot CLI, GitHub Codespaces, etc.)
- Simpler setup — no need to configure MCP server in agent environments
- JSON output support — most CLI commands support
--format Jsonfor machine-readable output
Reactions are currently unavailable