Skip to content

Add title for all MCP tools for consistent Visual Studio display#898

Merged
anannya03 merged 5 commits intomicrosoft:mainfrom
anannya03:add_title_to_namespace
Oct 21, 2025
Merged

Add title for all MCP tools for consistent Visual Studio display#898
anannya03 merged 5 commits intomicrosoft:mainfrom
anannya03:add_title_to_namespace

Conversation

@anannya03
Copy link
Copy Markdown
Contributor

What does this PR do?

Some MCP tools are missing the 'title' metadata, causing Visual Studio to display raw tool names instead of user-friendly titles. This results in an inconsistent user experience across different tool areas.

Modified Visual studio view-
Screenshot 2025-10-20 200758

GitHub issue number?

#872

Pre-merge Checklist

  • Required for All PRs
    • Read contribution guidelines
    • PR title clearly describes the change
    • Commit history is clean with descriptive messages (cleanup guide)
    • Added comprehensive tests for new/modified functionality
    • Updated servers/Azure.Mcp.Server/CHANGELOG.md and/or servers/Fabric.Mcp.Server/CHANGELOG.md for product changes (features, bug fixes, UI/UX, updated dependencies)
  • For MCP tool changes:
    • One tool per PR: This PR adds or modifies only one MCP tool for faster review cycles
    • Updated servers/Azure.Mcp.Server/README.md and/or servers/Fabric.Mcp.Server/README.md documentation
    • Validate README.md changes using script at eng/scripts/Process-PackageReadMe.ps1. See Package README
    • Updated command list in /servers/Azure.Mcp.Server/docs/azmcp-commands.md and/or /docs/fabric-commands.md
    • For new or modified tool descriptions, ran ToolDescriptionEvaluator and obtained a score of 0.4 or more and a top 3 ranking for all related test prompts
    • For new tools associated with Azure services or publicly available tools/APIs/products, add URL to documentation in the PR description
  • Extra steps for Azure MCP Server tool changes:
    • Updated test prompts in /servers/Azure.Mcp.Server/docs/e2eTestPrompts.md
    • 👉 For Community (non-Microsoft team member) PRs:
      • Security review: Reviewed code for security vulnerabilities, malicious code, or suspicious activities before running tests (crypto mining, spam, data exfiltration, etc.)
      • Manual tests run: added comment /azp run mcp - pullrequest - live to run Live Test Pipeline

Copy link
Copy Markdown
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 adds the Title property to all MCP tool area setups to provide user-friendly display names in Visual Studio. Previously, some tools lacked titles, causing Visual Studio to display raw tool names instead of formatted, readable titles. This change ensures consistent presentation across all tool areas.

Key changes:

  • Added Title property to the IAreaSetup interface and all implementing classes
  • Updated CommandGroup constructor to accept an optional title parameter
  • Modified tool loaders to use titles in tool annotations for proper Visual Studio display
  • Added title support to server registry configuration

Reviewed Changes

Copilot reviewed 58 out of 58 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
core/Azure.Mcp.Core/src/Areas/IAreaSetup.cs Added Title property to the interface
core/Azure.Mcp.Core/src/Commands/CommandGroup.cs Added optional title parameter to constructor
core/Azure.Mcp.Core/src/Areas/Server/Models/RegistryServerInfo.cs Added Title property to server info model
core/Azure.Mcp.Core/src/Areas/Server/Commands/Discovery/McpServerMetadata.cs Added Title property to metadata model
core/Azure.Mcp.Core/src/Areas/Server/Commands/ToolLoading/ServerToolLoader.cs Updated to include title in tool annotations
core/Azure.Mcp.Core/src/Areas/Server/Commands/ToolLoading/NamespaceToolLoader.cs Updated to include title in tool annotations
core/Azure.Mcp.Core/src/Areas/Server/Commands/Discovery/RegistryServerProvider.cs Updated to populate title in metadata
core/Azure.Mcp.Core/src/Areas/Server/Commands/Discovery/CommandGroupServerProvider.cs Updated to populate title in metadata
core/Azure.Mcp.Core/src/Areas/Server/Resources/registry.json Added titles for documentation and azd servers
tools/*.Setup.cs (40+ files) Added Title property implementations and passed titles to CommandGroup constructors
core/Azure.Mcp.Core/tests/Azure.Mcp.Core.UnitTests/* Updated tests to verify title behavior
core/Azure.Mcp.Core/tests/Azure.Mcp.Core.LiveTests/* Updated tests to use titles instead of tool names

@anannya03 anannya03 force-pushed the add_title_to_namespace branch from c29dcd0 to 7b5e66f Compare October 21, 2025 08:23
@anannya03
Copy link
Copy Markdown
Contributor Author

/azp run mcp - pullrequest - live

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines successfully started running 1 pipeline(s).

Comment thread tools/Azure.Mcp.Tools.Redis/src/RedisSetup.cs Outdated
@joshfree joshfree moved this from Untriaged to In Progress in Azure MCP Server Oct 21, 2025
@joshfree joshfree added this to the 2025-10 milestone Oct 21, 2025
@joshfree joshfree added server-Azure.Mcp Azure.Mcp.Server tools-Core AZMCP Core functionality that all other tools build on top of labels Oct 21, 2025
Co-authored-by: Philo <philon@microsoft.com>
@joshfree
Copy link
Copy Markdown
Member

@xiangyan99 please review this for the change to mcp tool hints.

@vcolin7 let's include this change in today's release

@anannya03 anannya03 enabled auto-merge (squash) October 21, 2025 19:38
@anannya03 anannya03 merged commit c65002d into microsoft:main Oct 21, 2025
53 checks passed
@github-project-automation github-project-automation Bot moved this from In Progress to Done in Azure MCP Server Oct 21, 2025
colbytimm pushed a commit to colbytimm/microsoft-mcp that referenced this pull request Dec 8, 2025
…rosoft#898)

* Add title for all tools

* fixed issues regarding registry tools not showing up and live tests

* core live test fix

* Update tools/Azure.Mcp.Tools.Redis/src/RedisSetup.cs

Co-authored-by: Philo <philon@microsoft.com>

* core live tests

---------

Co-authored-by: Josh Free <joshfree@users.noreply.github.com>
Co-authored-by: Philo <philon@microsoft.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

server-Azure.Mcp Azure.Mcp.Server tools-Core AZMCP Core functionality that all other tools build on top of

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

5 participants