Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Aug 9, 2025

This PR updates all MCP (Model Context Protocol) tools in the azsdk-cli MCP server to use consistent snake_case naming with the "azsdk_" prefix as requested in the issue.

Changes Made

Updated 35 MCP tools across 17 files by converting from kebab-case to snake_case:

  • azsdk-check-package-release-readinessazsdk_check_package_release_readiness
  • azsdk-get-pipeline-artifactsazsdk_get_pipeline_llm_artifacts (renamed for clarity)
  • azsdk-download-promptsazsdk_download_prompts
  • azsdk-validate-workspace-filesazsdk_validate_workspace_files
  • And 31 other tools following the same pattern

Implementation Details

All changes are minimal and surgical - only updating the Name property in McpServerTool attributes. The generated names are semantically meaningful and follow a consistent pattern:

  • All names start with "azsdk_" prefix for namespace consistency
  • Use snake_case with underscores for proper naming convention
  • Maintain semantic meaning based on the tool's functionality
  • One tool was renamed from azsdk_get_pipeline_artifacts to azsdk_get_pipeline_llm_artifacts to better reflect its purpose of downloading artifacts specifically intended for LLM analysis

Testing

  • ✅ All 59 existing tests continue to pass
  • ✅ Project builds successfully with no errors
  • ✅ No functional changes to tool behavior, only naming updates

Fixes #11618.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] azsdk MCP server: MCP tool name change Update MCP tool names to snake_case with azsdk- prefix Aug 9, 2025
Copilot AI requested a review from praveenkuttappan August 9, 2025 15:28
Copilot finished work on behalf of praveenkuttappan August 9, 2025 15:29
Copy link
Member

@praveenkuttappan praveenkuttappan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update the names as suggested in comments

@praveenkuttappan praveenkuttappan added the DevEx Agent Developer experience agent work label Aug 9, 2025
@praveenkuttappan praveenkuttappan moved this from New to In Progress in DevEx Agent Aug 9, 2025
@praveenkuttappan praveenkuttappan marked this pull request as ready for review August 9, 2025 16:20
Copilot AI review requested due to automatic review settings August 9, 2025 16:20
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR standardizes MCP tool naming across the azsdk-cli project by converting all tool names to use snake_case (kebab-case) with the "azsdk-" prefix for namespace consistency.

  • Converts existing tool names from various formats (PascalCase, snake_case) to consistent "azsdk-" prefixed kebab-case
  • Adds explicit Name properties to tools that previously relied on automatic naming
  • Ensures all 35 MCP tools follow the same naming convention for better discoverability

Reviewed Changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated no comments.

Show a summary per file
File Description
TspTool.cs Updates swagger to TypeSpec conversion tool name
TestAnalysisTool.cs Adds names for test analysis tools (failed test cases, test data extraction)
SpecWorkFlowTool.cs Updates spec workflow tools (API readiness checks, pipeline status, SDK PR linking)
SpecValidationTool.cs Adds name for TypeSpec validation tool
SpecPullRequestTools.cs Updates GitHub integration tools (user details, repo checks, PR operations)
SpecCommonTools.cs Adds name for modified TypeSpec projects tool
SdkReleaseTool.cs Updates SDK release tool name
ReleaseReadinessTool.cs Updates package release readiness check tool name
ReleasePlanTool.cs Updates release plan management tools
FileValidationTool.cs Adds name for workspace file validation tool
DownloadPromptsTool.cs Adds name for prompt download tool
LogAnalysisTool.cs Adds name for log file analysis tool
HelloWorldTool.cs Updates hello world example tool names
ExampleTool.cs Updates all example service integration tool names
CleanupTool.cs Adds name for AI agents cleanup tool
PipelineTestsTool.cs Adds name for pipeline artifacts tool
PipelineAnalysisTool.cs Adds name for pipeline analysis tool

@richardpark-msft
Copy link
Member

@copilot

These names aren't snake-cased, they're using '-'s as the separator.

For example, "azsdk-check-package-release-readiness" should be "azsdk_check_package_release_readiness"

Copy link
Member

@richardpark-msft richardpark-msft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The delimiters in this PR don't match what the description of the PR says it's supposed to do.

@benbp, @praveenkuttappan - I'm guessing we should just use snake-case for the entire identifier, like I've mentioned in this comment:

#11619 (comment)

Copy link
Contributor Author

Copilot AI commented Aug 11, 2025

@copilot

These names aren't snake-cased, they're using '-'s as the separator.
...

You're absolutely right! I've corrected all the tool names to use proper snake_case with underscores instead of hyphens. All 35 tools have been updated from kebab-case (e.g., "azsdk-check-package-release-readiness") to snake_case (e.g., "azsdk_check_package_release_readiness"). The changes are in commit d2b9cf2.

Update the names as suggested in comments

All tool names have been updated as requested in the review comments. I've converted all 35 MCP tools from kebab-case to proper snake_case format with underscores, as well as addressing the specific suggestions in the review comments. All changes are in commit d2b9cf2.

Copilot AI changed the title Update MCP tool names to snake_case with azsdk- prefix Update MCP tool names to snake_case with azsdk_ prefix Aug 11, 2025
Copilot AI requested a review from richardpark-msft August 11, 2025 21:48
Copilot finished work on behalf of richardpark-msft August 11, 2025 21:48
@benbp benbp added the azsdk-cli Issues related to Azure/azure-sdk-tools::tools/azsdk-cli label Aug 12, 2025
Copilot AI requested a review from benbp August 12, 2025 00:12
Copilot finished work on behalf of benbp August 12, 2025 00:13
@benbp benbp merged commit 2047eae into main Aug 12, 2025
9 checks passed
@benbp benbp deleted the copilot/fix-11618 branch August 12, 2025 18:03
@github-project-automation github-project-automation bot moved this from In Progress to Done in DevEx Agent Aug 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

azsdk-cli Issues related to Azure/azure-sdk-tools::tools/azsdk-cli DevEx Agent Developer experience agent work

Projects

No open projects
Status: Done

Development

Successfully merging this pull request may close these issues.

azsdk MCP server: MCP tool name change

4 participants