.NET SSE MCP Server - Student Information

A modern .NET 9.0 web API that implements the Model Context Protocol (MCP) server with Server-Sent Events (SSE) transport, providing a comprehensive student management system with both REST API endpoints and MCP tools.

🚀 Features

• Model Context Protocol (MCP) Server: Implements MCP specification for AI model integration
• Server-Sent Events (SSE) Transport: Real-time communication capabilities
• REST API Endpoints: Traditional HTTP endpoints for student management
• Swagger/OpenAPI Documentation: Interactive API documentation
• Student Management: Complete CRUD operations for student data
• Advanced Queries: Filter students by major, GPA, and custom fields
• Statistics: Generate comprehensive student statistics
• Modern .NET 9.0: Built with the latest .NET framework

📋 Prerequisites

• .NET 9.0 SDK
• Visual Studio 2022 or VS Code
• Git

🛠️ Installation & Setup

1. Clone the repository

   git clone https://github.com/yourusername/dot-net-sse-mcp-server.git
   cd dot-net-sse-mcp-server
   

2. Navigate to the project directory

   cd StudentWebAPIWithMCPServer
   

3. Restore dependencies

   dotnet restore
   

4. Run the application

   dotnet run
   

The application will start on https://localhost:7000 (or the configured port in launchSettings.json).

📚 API Documentation

Once the application is running, you can access:

• Swagger UI: https://localhost:7000/swagger
• OpenAPI JSON: https://localhost:7000/openapi.json

🔧 MCP Tools

The server exposes the following MCP tools:

Student Management Tools

| Tool | Description | Parameters | |------|-------------|------------| | GetAllStudents | Retrieves all students | None | | GetStudentById | Gets a specific student by ID | id (int) | | GetStudentsByMajor | Filters students by major | major (string) | | GetStudentsWithGpaAbove | Gets students with GPA above threshold | minGpa (double) | | AddStudent | Adds a new student | id, firstName, lastName, dateOfBirth, email, gpa, major | | GetStudentStatistics | Returns comprehensive statistics | None | | GetStudentsWithFields | Returns students with specified fields only | fieldsToInclude (List) |

🌐 REST API Endpoints

Student Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /Student/GetAllStudents | Get all students | | POST | /Student/GetStudentById | Get student by ID | | POST | /Student/GetStudentsByMajor | Filter by major | | POST | /Student/GetStudentsWithGpaAbove | Filter by minimum GPA | | POST | /Student/AddStudent | Add new student | | POST | /Student/GetStudentStatistics | Get statistics | | POST | /Student/GetStudentsWithFields | Get students with specific fields |

Example API Calls

Get All Students

curl -X POST "https://localhost:7000/Student/GetAllStudents" \
     -H "Content-Type: application/json"

Add New Student

curl -X POST "https://localhost:7000/Student/AddStudent" \
     -H "Content-Type: application/json" \
     -d '{
       "id": 7,
       "firstName": "Alice",
       "lastName": "Johnson",
       "dateOfBirth": "2002-04-15",
       "email": "alice.j@university.edu",
       "gpa": 3.85,
       "major": "Computer Science"
     }'

Get Students by Major

curl -X POST "https://localhost:7000/Student/GetStudentsByMajor" \
     -H "Content-Type: application/json" \
     -d '"Computer Science"'

📊 Student Model

public class Student
{
    public int Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public DateTime DateOfBirth { get; set; }
    public string Email { get; set; }
    public double GPA { get; set; }
    public string Major { g

... [View full README on GitHub](https://github.com/srijonchakraborty/dot-net-sse-mcp-server#readme)