mcp-workshop-01-first
MCP server from nikosdelis/mcp-workshop-01-first-server
claude mcp add --transport stdio nikosdelis-mcp-workshop-01-first-server dotnet run
How to use
This MCP server is a minimal ASP.NET Core web server implemented in C#. It starts a basic web application that listens for HTTP requests and responds with a simple message (as defined in Program.cs). By default, the server exposes a root endpoint and will respond to requests such as http://localhost:5000 with the configured message. You can customize the response or add additional endpoints by editing Program.cs.
To use the server, run it using the MCP configuration and then send HTTP requests to the available routes. The default behavior is a straightforward hello-like response, suitable for demonstrations or starting points for simple APIs.
How to install
Prerequisites:
- .NET SDK installed on your machine (https://dotnet.microsoft.com/download)
Steps:
- Clone the repository or download the source code.
- Open a terminal and navigate to the project directory.
- Run the server:
dotnet run
- Open a browser or tool and navigate to the default address:
http://localhost:5000
Notes:
- The default port is 5000, but it can be changed by editing Program.cs or configuring Kestrel/ASPNETCORE_URLS.
- If you modify Program.cs, rebuild the project by running
dotnet runagain to apply changes.
Additional notes
Tips and common considerations:
- The default URL is http://localhost:5000. If you need to expose the server on a different port, set ASPNETCORE_URLS, or modify the code to bind to a specific URL.
- If you encounter port conflicts, stop other processes using port 5000 or configure a different port.
- For production deployment, consider hosting behind a reverse proxy and configuring proper logging, error handling, and security headers.
- Since this is a minimal example, endpoints and responses are defined in Program.cs; customize the routing and responses there to fit your needs.
Related MCP Servers
mssql
MSSQL Server MCP implementation written in C#
McpDotNet.Extensions.SemanticKernel
Microsoft SemanticKernel integration for the Model Context Protocol (MCP). Enables seamless use of MCP tools as AI functions.
DatabaseMcpServer
MCP server from ttcc666/DatabaseMcpServer
mcp-dataverse
MCP Server for querying Dataverse using SQL
xperience-community
ASP.NET Core MCP server for Xperience by Kentico projects
console-to-http
Example of converting a stdio MCP server to HTTP using ModelContextProtocol.AspNetCore