RorroRojas3/mcp-server

RR.MCPServer

A Model Context Protocol (MCP) server implementation in C# that provides recipe management tools through the DummyJSON API. This server demonstrates how to build MCP tools for external API integration with robust error handling and logging.

Overview

This MCP server exposes recipe-related functionality to AI assistants and other MCP clients. It provides tools for searching, retrieving, and browsing recipes from the DummyJSON API, along with a simple echo tool for testing connectivity.

Features

• Recipe Management Tools:
  • Get recipe by ID
  • Search recipes by query
  • Browse recipes with pagination, sorting, and field selection
• Echo Tool: Simple message echoing for testing
• Robust Error Handling: Comprehensive validation and error reporting
• Structured Logging: Console logging with proper log levels
• Type-Safe DTOs: Well-defined data transfer objects for API responses

Technology Stack

• Framework: .NET 9.0
• MCP Library: ModelContextProtocol v0.3.0-preview.3
• HTTP Client: Microsoft.Extensions.Http for API calls
• Dependency Injection: Microsoft.Extensions.DependencyInjection
• Logging: Microsoft.Extensions.Logging with console output
• Configuration: Microsoft.Extensions.Configuration with JSON support

Project Structure

RR.MCPServer/
├── RR.MCPServer/                 # Main executable project
│   ├── Program.cs               # Application entry point and MCP server setup
│   ├── appsettings.json         # Configuration (DummyJSON API URL)
│   └── RR.MCPServer.csproj      # Project file
├── RR.MCPServer.Tool/           # MCP tools implementation
│   └── DummyJsonTool.cs         # Recipe API tools
├── RR.MCPServer.Dto/            # Data transfer objects
│   ├── RecipeDto.cs             # Individual recipe model
│   └── RecipeSearchDto.cs       # Recipe search results model
└── .vscode/
    └── mcp.json                 # VS Code MCP client configuration

Available Tools

1. Echo Tool

• Purpose: Test server connectivity
• Method: Echo(string message)
• Returns: "hello {message}"

2. Get Recipe By ID

• Purpose: Retrieve a specific recipe by its unique identifier
• Method: GetRecipeByIdAsync(int recipeId)
• Parameters:
  • recipeId: The unique identifier of the recipe
• Returns: JSON serialized recipe data

3. Search Recipes

• Purpose: Search for recipes using a query string
• Method: SearchRecipeAsync(string query)
• Parameters:
  • query: Search terms to find recipes
• Returns: JSON serialized search results

4. Get Recipes (Browse)

• Purpose: Browse recipes with advanced options
• Method: GetRecipesAsync(...)
• Parameters:
  • limit: Number of recipes to retrieve (default: 10, use 0 for all)
  • skip: Number of recipes to skip for pagination (default: 0)
  • select: Comma-separated fields to select (optional)
  • sortBy: Field name to sort by (optional)
  • order: Sort order 'asc' or 'desc' (default: 'asc')
• Returns: JSON serialized recipe list with pagination info

Prerequisites

• .NET 9.0 SDK
• Visual Studio Code (recommended for MCP integration)

Installation & Setup

1. Clone the repository:

   git clone <repository-url>
   cd RR.MCPServer
   

2. Restore dependencies:

   dotnet restore
   

3. Build the project:

   dotnet build
   

Running the Server

Option 1: Direct Execution

cd RR.MCPServer
dotnet run

Option 2: VS Code MCP Integration

1. Ensure the .vscode/mcp.json configuration is present
2. The server will automatically start when accessed through VS Code's MCP client
3. Configuration includes proper working directory setup for appsettings.json

Option 3: Production Build

dotnet publish -c Release -o ./publish
cd publish
./RR.MCPServer.exe

Configuration

The server uses appsettings.json for configuration:

{
  "DummyJSON": {
    "Url": "https://dummyjson.com"
  }
}

Example Usage

Once connected through an MCP client, you can use the tools:

# Echo test
Echo("test") → "hello test"

# Get specific recipe
GetRecipeByIdAsync(1) → Returns Classic Margherita Pizza details

# Search for recipes
SearchRecipeAsync("pizza") → Returns pizza-related recipes

# Browse recipes with pagination
GetRecipesAsync(5, 0) → Returns first 5 recipes

Development

Adding New Tools

1. Create methods in DummyJsonTool.cs or new tool classes
2. Decorate with [McpServerTool] and [Description] attributes
3. Mark the class with [McpServerToolType]
4. Register in Program.cs using .WithTools<YourToolClass>()

Logging

All operations are logged to stderr with appropriate log levels:

• Information: Normal operations
• Warning: Non-critical issues (e.g., no results found)
• Error: Critical errors with validation failures

License

[Include your license information here]

Contributing

[Include contribution guidelines here]