Add quickstart for minimal MCP Server using .NET and publish to NuGet #47007
Conversation
JonDouglas
requested review from
gewarren,
alexwolfmsft and
a team
as code owners
| 1. In a terminal window, install the `dotnet new mcpserver` template: | ||
|
|
||
| ```bash | ||
| dotnet new install Microsoft.Extensions.AI.Templates::9.6.0-preview.2.25310.2 |
There was a problem hiding this comment.
TODO: update to the correct package version
(we don't know it yet)
There was a problem hiding this comment.
For reference, the draft template is here: dotnet/extensions#6547
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Joel Verhagen <[email protected]>
i'm not sure what the best approach is! either works. |
|
|
||
| ## Discover MCP servers on NuGet.org | ||
|
|
||
| 1. Search for your MCP Server package on [NuGet.org](https://www.nuget.org/packages?packagetype=mcpserver). |
There was a problem hiding this comment.
TODO: add screenshots from NuGet.org
@alexwolfmsft, @timheuer, and I met and we decide to try merging the two documents. I have updated the PR accordingly. |
|
|
||
| 1. Update the tool code to use an environment variable. Add another tool method after the `GetRandomNumber` method in `Tools/RandomNumberTools.cs`: | ||
|
|
||
| ```csharp |
There was a problem hiding this comment.
Can you put the code in a separate file and reference it like this?
There was a problem hiding this comment.
@gewarren will do! I will put just the method (as I have here) not the whole file and see how it looks. LMK if that's wrong.
|
|
||
| :::image type="content" source="../media/mcp/available-tools.png" alt-text="A screenshot showing the available MCP tools."::: | ||
| 1. Select the **Select tools** icon to verify your **SampleMcpServer** is available with the sample tool listed. |
There was a problem hiding this comment.
Is the get random number tool installed with the template?
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Summary
Adds a quickstart of creating a minimal MCP server with a predefined
mcpservertemplate, consuming it locally, and publishing it to NuGet and consuming it from the package ID as well usingdotnet tool exec.Internal previews