mcp-products-server

Overview

The MCP Products Server is a comprehensive implementation using the .NET Model Context Protocol SDK, Semantic Kernel, and Aspire. It exposes product search capabilities through hybrid vector and full-text search, plus tools to generate, retrieve, update, and delete marketing summaries. The architecture includes an HTTP JSON-RPC transport layer, comprehensive logging, and Azure Cosmos DB for data storage. The project also includes a Blazor client application for testing and demonstration purposes.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• hybrid_search_products

  Vector + keyword search for semantic understanding

  Try:Find mountain bikes under $1000Try:Search for road bikes with 21 speeds
• get_product_by_id

  Retrieve a specific product by ID

  Try:Get product details for SKU B123Try:Find information about product 456
• generate_product_summary

  Create marketing summaries with AI-generated content

  Try:Generate marketing copy for a road bikeTry:Write a description for a mountain bike
• get_product_summary

  Retrieve existing product summaries

  Try:Get the marketing summary for product 123Try:Show summary for SKU B456
• update_product_summary

  Update marketing content while preserving automated fields

  Try:Update the marketing summary for product 123Try:Revise description for city bike
• delete_product_summary

  Remove product summaries

  Try:Delete the summary for product 123Try:Remove marketing copy for SKU B456
• list_product_summaries

  Get all summaries in the database

  Try:List all product summariesTry:Show all marketing descriptions

Comparable tools

Installation

git clone <repository-url>
cd mcp-products-server

cd mcp-products-server.AppHost
dotnet run

# Terminal 1: MCP Server
cd mcp-products-server
dotnet run

# Terminal 2: Blazor Client
cd mcp-products-client
dotnet run

{
  "mcpServers": {
    "products-server": {
      "command": "dotnet",
      "args": ["run"],
      "cwd": "/path/to/mcp-products-server"
    }
  }
}

FAQ

What database is used by this MCP server?

The server uses Azure Cosmos DB for both vector search and document storage of product data and marketing summaries.

Can I add custom tools to this server?

Yes, you can create new tool classes in the Tools/ directory with [McpServerTool] attributes, and they'll be automatically discovered and integrated.

Compare mcp-products-server with