csharp-mcp-client-server-demo

DucLe-2005/csharp-mcp-client-server-demo

3.1

If you are the rightful owner of csharp-mcp-client-server-demo and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project is a simple implementation of a Model Context Protocol (MCP) system using .NET, consisting of a server and a client.

🧩 MCP Client–Server Demo (.NET)

This project is a simple implementation of a Model Context Protocol (MCP) system using .NET, consisting of two components:

  • Server — a minimal MCP server exposing tools via stdio transport
  • Client — a .NET console client that connects to the server and interacts with an LLM through the MCP protocol

This demo follows Microsoft’s Model Context Protocol for Beginners and is meant as a learning project for understanding how MCP clients and servers communicate in .NET.

🧠 Overview

The Model Context Protocol (MCP) defines how AI models and tools can exchange structured messages over a standardized transport layer (like stdio or SSE).
This demo helps you understand:

  • How an MCP server exposes tools using .NET and dependency injection
  • How an MCP client connects and interacts with the model
  • How messages are exchanged via JSON-RPC and serialized in the MCP format

📁 Project Structure

mcp-dotnet-demo/
│
├── Client/        # The MCP client that sends requests and interacts with the LLM
└── Server/        # The MCP server that exposes tools and handles requests

⚙️ Getting Started

1️⃣ Clone this repository

git clone https://github.com/<your-username>/mcp-dotnet-demo.git
cd mcp-dotnet-demo

2️⃣ Install prerequisites

Make sure you have the following installed:

  • .NET SDK 8.0+
  • (Optional) Node.js if you want to use the MCP Inspector (npx @modelcontextprotocol/inspector)

3️⃣ Build and run the Server

cd Server
dotnet build
dotnet run

The server will start and listen via stdio transport.
It exposes basic MCP tools defined in your C# project.

4️⃣ Build and run the Client

In another terminal:

cd Client
dotnet build
dotnet run

The client will connect to the MCP server and send messages to interact with the LLM.
You should see structured request/response messages printed in the console.

5️⃣ (Optional) Inspect with MCP Inspector

You can visualize the client-server interaction using the MCP Inspector tool:

npx @modelcontextprotocol/inspector dotnet run --project ./Server

🧰 Technologies Used

  • C# / .NET 8
  • Microsoft.Extensions.Hosting
  • ModelContextProtocol SDK
  • JSON-RPC / stdio Transport

📚 References

🪄 License

This project is provided for educational and demo purposes.
See the MCP for Beginners License for reference.