Skip to content

Add additional attributes to generate MD files #2581

@alzimmermsft

Description

@alzimmermsft

With the recent change to use an Attribute to define the tool command definition, we should look into adding additional Attributes that can be used to automatically generated MD files that reference tools. Example MD files are

  • azmcp-commands.md
  • e2eTestPrompts.md (easiest addition)
  • README.md's "What can you do with the Azure MCP Server?" section

Right now, those sections are additional work needed to be done while creating or modifying tool commands.

Instead, we could create tooling that consumes the source of a given MCP server to generate these files in a consistent way. And it'll put adding this information in line with the tool command itself.

[CommandMetadata(
    Id = "eb2363f1-f21f-45fc-ad63-bacfbae8c45c",
    Name = "get",
    Title = "Get Storage Account Details",
    Description = "Retrieves detailed information about Azure Storage accounts, including account name, location, SKU, kind, hierarchical namespace status, HTTPS-only settings, and blob public access configuration. If a specific account name is not provided, the command will return details for all accounts in a subscription.",
    Destructive = false,
    Idempotent = true,
    OpenWorld = false,
    ReadOnly = true,
    Secret = false,
    LocalRequired = false)]
[ExamplePrompts(
    "Show me the details for my storage account <account>",
    "Get details about the storage account <account>",
    "List all storage accounts in my subscription including their location and SKU",
    "Show me my storage accounts with whether hierarchical namespace (HNS) is enabled",
    "Show me the storage accounts in my subscription and include HTTPS-only and public blob access settings")]

public sealed class AccountGetCommand(ILogger<AccountGetCommand> logger, IStorageService storageService) : SubscriptionCommand<AccountGetOptions>()

Metadata

Metadata

Assignees

Labels

needs-team-attentionWorkflow: This issue needs attention from Azure service team or MCP team.server-Azure.McpAzure.Mcp.Servertools-CoreAZMCP Core functionality that all other tools build on top of

Type

No type

Projects

Status

Untriaged

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions