Python: Normalize MCP function names to allowed tool calling values. Add tests.

[moonbox3]

Motivation and Context

When using some MCP plugins, the tool names or prompt names may contain invalid chars that cause function calling to throw a 400. The following is such a case:

async with MCPStdioPlugin(
        name="nasa",
        description="nasa Plugin",
        command="docker",
        args=["run","-i","--rm","ghcr.io/metorial/mcp-container--programcomputer--nasa-mcp-server--nasa-mcp-server","npm run start"]
    ) as nasa_plugin:
        agent = ChatCompletionAgent(
            service=AzureChatCompletion(),
            name="NasaAgent",
            instructions="Answer questions about Nasa.",
            plugins=[nasa_plugin],
        )

Some prompt tools with that MCP server contain / (forward slashes), which cause the OpenAI model to throw a 400 due to a failed regex.

prompt_list.prompts
Prompt(name='nasa/get-astronomy-picture', description="Fetch NASA's Astronomy Picture...nail for video content', required=False)]), 
Prompt(name='nasa/browse-near-earth-objects', description='Find near-Earth asteroids ...rch (YYYY-MM-DD format)', required=True)]),
...

We will introduce name normalization when we're loading the kernel functions, and replace any non-allowed values with a hyphen (-). This then allows to be called successfully.

Description

• Name normalize any tool or prompt tools from an MCP server.
• Closes Python: Bug: MCP error calling Nasa MCP server #12406
• Adds unit test coverage

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the SK Contribution Guidelines and the pre-submission formatting script raises no violations
• All unit tests pass, and I have added new tests where possible
• I didn't break anyone 😄

[markwallace-microsoft]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
connectors
mcp.py	387	187	51%	74, 86, 94–97, 99–100, 105, 117–122, 130–134, 136–137, 139, 146–148, 235–237, 252–253, 256–257, 269–270, 274–275, 277, 279, 281–287, 291–293, 295–305, 309–310, 314–315, 319, 321, 325–326, 330, 344, 359–367, 373–374, 376–377, 380–381, 387–388, 408–409, 412–413, 416–421, 425–426, 429–430, 433–439, 448–450, 530, 532, 599, 601, 603, 605, 674, 676, 678, 680, 682, 740, 783–788, 790–793, 798, 851, 853, 856, 869, 889–891, 896–905, 907, 911–912, 914, 917–918, 927–928, 930–932, 946–947, 949–950, 952–954, 957, 964–967, 975, 980–985, 990, 992, 995–998
TOTAL	27112	4620	82%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
3626	22 💤	0 ❌	0 🔥	1m 56s ⏱️