Skip to content

Update the aspire skill to use the CLI instead of the MCP server #14619

@davidfowl

Description

@davidfowl

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

  1. Update SkillFileContent in CommonAgentApplicators.cs — replace all references to MCP tools with their CLI command equivalents.
  2. Update the skill description — remove "Aspire MCP tools" references and replace with CLI commands.
  3. Update the debugging section — replace tool references like _list structured logs_ with aspire telemetry logs, etc.
  4. Update the documentation section — replace list_docs/search_docs/get_doc MCP tool references with aspire docs list/aspire docs search/aspire docs get.
  5. Update the "Checking resources" section — replace _list resources_ tool / _execute resource command_ tool with aspire resources / aspire command.
  6. Update the "Other Aspire MCP tools" section — replace with CLI equivalents (aspire ps, --project flag).
  7. 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 Json for machine-readable output

Metadata

Metadata

Labels

Type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions