Skip to content

Document MCP Server project template in README #1148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
leslierichardson95 wants to merge 1 commit into
base: main
Choose a base branch
from
+4 −0
Open

Document MCP Server project template in README #1148

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,10 @@ var response = await chatClient.GetResponseAsync(

## Getting Started (Server)

### MCP Server Project Template
Copy link
Collaborator

@MackinnonBuck MackinnonBuck Jan 21, 2026

Choose a reason for hiding this comment

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

I wonder if we should put the content after this paragraph in another subsection to more clearly separate the "project template" documentation from the usage examples.

Or we could:

  • Put this paragraph its own section after the "Getting Started (Server)" section
  • Put a "tip" block in the existing section like this:

Tip

You can use the MCP Server project template to quickly get started with creating your own MCP server.

Thoughts?

Copy link
Contributor

@mikekistler mikekistler Jan 22, 2026

Choose a reason for hiding this comment

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

I like the tip block suggestion!


You can create your own MCP server by using the MCP Server project template. This template will set you up with a working MCP server containing a random number tool that returns a random number between a specified min and max value. This template also lets you select an MCP transport type (stdio or http) and it will confgure the MCP Server based on that choice. To learn more about the template, read this MS Learn doc on [creating minimal MCP servers](https://learn.microsoft.com/en-us/dotnet/ai/quickstarts/build-mcp-server).
Copy link
Contributor

@mikekistler mikekistler Jan 22, 2026

Choose a reason for hiding this comment

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

Typo

Suggested change
You can create your own MCP server by using the MCP Server project template. This template will set you up with a working MCP server containing a random number tool that returns a random number between a specified min and max value. This template also lets you select an MCP transport type (stdio or http) and it will confgure the MCP Server based on that choice. To learn more about the template, read this MS Learn doc on [creating minimal MCP servers](https://learn.microsoft.com/en-us/dotnet/ai/quickstarts/build-mcp-server).
You can create your own MCP server by using the MCP Server project template. This template will set you up with a working MCP server containing a random number tool that returns a random number between a specified min and max value. This template also lets you select an MCP transport type (stdio or http) and it will configure the MCP Server based on that choice. To learn more about the template, read this MS Learn doc on [creating minimal MCP servers](https://learn.microsoft.com/en-us/dotnet/ai/quickstarts/build-mcp-server).


Here is an example of how to create an MCP server and register all tools from the current application.
It includes a simple echo tool as an example (this is included in the same file here for easy of copy and paste, but it needn't be in the same file...
the employed overload of `WithTools` examines the current assembly for classes with the `McpServerToolType` attribute, and registers all methods with the
Expand Down