test

dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step09_UsingMcpClientAsTools/FoundryAgents_Step09_UsingMcpClientAsTools.csproj

@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFrameworks>net10.0</TargetFrameworks>
+
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <UserSecretsId>3afc9b74-af74-4d8e-ae96-fa1c511d11ac</UserSecretsId>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Azure.AI.Agents.Persistent" />
+    <PackageReference Include="Azure.Identity" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" />
+    <PackageReference Include="ModelContextProtocol" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\..\src\Microsoft.Agents.AI.AzureAI\Microsoft.Agents.AI.AzureAI.csproj" />
+  </ItemGroup>
+  
+</Project>

dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step09_UsingMcpClientAsTools/Program.cs

@@ -0,0 +1,47 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+// This sample shows how to expose an AI agent as an MCP tool.
+
+using Azure.AI.Projects;
+using Azure.Identity;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using ModelContextProtocol.Client;
+
+string endpoint = Environment.GetEnvironmentVariable("AZURE_FOUNDRY_PROJECT_ENDPOINT") ?? throw new InvalidOperationException("AZURE_FOUNDRY_PROJECT_ENDPOINT is not set.");
+string deploymentName = Environment.GetEnvironmentVariable("AZURE_FOUNDRY_PROJECT_DEPLOYMENT_NAME") ?? "gpt-4o-mini";
+
+Console.WriteLine("Starting MCP Stdio for @modelcontextprotocol/server-github ... ");
+
+// Create an MCPClient for the GitHub server
+await using var mcpClient = await McpClient.CreateAsync(new StdioClientTransport(new()
+{
+    Name = "MCPServer",
+    Command = "npx",
+    Arguments = ["-y", "--verbose", "@modelcontextprotocol/server-github"],
+}));
+
+// Retrieve the list of tools available on the GitHub server
+IList<McpClientTool> mcpTools = await mcpClient.ListToolsAsync();
+string agentName = "AgentWithMCP";
+// Get a client to create/retrieve/delete server side agents with Azure Foundry Agents.
+AIProjectClient aiProjectClient = new(new Uri(endpoint), new AzureCliCredential());
+
+Console.WriteLine($"Creating the agent '{agentName}' ...");
+
+// Define the agent you want to create. (Prompt Agent in this case)
+AIAgent agent = await aiProjectClient.CreateAIAgentAsync(
+    name: agentName,
+    model: deploymentName,
+    instructions: "You answer questions related to GitHub repositories only.",
+    tools: [.. mcpTools.Cast<AITool>()]);
+
+string prompt = "Summarize the last four commits to the microsoft/semantic-kernel repository?";
+
+Console.WriteLine($"Invoking agent '{agent.Name}' with prompt: {prompt} ...");
+
+// Invoke the agent and output the text result.
+Console.WriteLine(await agent.RunAsync(prompt));
+
+// Clean up the agent after use.
+await aiProjectClient.Agents.DeleteAgentAsync(agent.Name);

dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step09_UsingMcpClientAsTools/README.md

@@ -0,0 +1,50 @@
+# Using MCP Client Tools with AI Agents
+
+This sample demonstrates how to use Model Context Protocol (MCP) client tools with AI agents, allowing agents to access tools provided by MCP servers. This sample uses the GitHub MCP server to provide tools for querying GitHub repositories.
+
+## What this sample demonstrates
+
+- Creating MCP clients to connect to MCP servers (GitHub server)
+- Retrieving tools from MCP servers
+- Using MCP tools with AI agents
+- Running agents with MCP-provided function tools
+- Managing agent lifecycle (creation and deletion)
+
+## Prerequisites
+
+Before you begin, ensure you have the following prerequisites:
+
+- .NET 10 SDK or later
+- Azure Foundry service endpoint and deployment configured
+- Azure CLI installed and authenticated (for Azure credential authentication)
+- Node.js and npm installed (for running the GitHub MCP server)
+
+**Note**: This demo uses Azure CLI credentials for authentication. Make sure you're logged in with `az login` and have access to the Azure Foundry resource. For more information, see the [Azure CLI documentation](https://learn.microsoft.com/cli/azure/authenticate-azure-cli-interactively).
+
+Set the following environment variables:
+
+```powershell
+$env:AZURE_FOUNDRY_PROJECT_ENDPOINT="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project" # Replace with your Azure Foundry resource endpoint
+$env:AZURE_FOUNDRY_PROJECT_DEPLOYMENT_NAME="gpt-4o-mini"  # Optional, defaults to gpt-4o-mini
+```
+
+## Run the sample
+
+Navigate to the FoundryAgents sample directory and run:
+
+```powershell
+cd dotnet/samples/GettingStarted/FoundryAgents
+dotnet run --project .\FoundryAgents_Step09_UsingMcpClientAsTools
+```
+
+## Expected behavior
+
+The sample will:
+
+1. Start the GitHub MCP server using `@modelcontextprotocol/server-github`
+2. Create an MCP client to connect to the GitHub server
+3. Retrieve the available tools from the GitHub MCP server
+4. Create an agent named "AgentWithMCP" with the GitHub tools
+5. Run the agent with a prompt to summarize the last four commits to the microsoft/semantic-kernel repository
+6. The agent will use the GitHub MCP tools to query the repository information
+7. Clean up resources by deleting the agent