Rust MCP Server

A high-performance Model Context Protocol (MCP) server built in Rust and deployed on AWS Lambda. This server provides product search capabilities through various tools, demonstrating a complete serverless MCP implementation.

📋 Table of Contents

• Infrastructure
• Logic
• Connections

🏗️ Infrastructure

Architecture Overview

This project uses AWS CDK (Cloud Development Kit) with TypeScript to deploy a Rust-based Lambda function with the following components:

• AWS Lambda Function: Serverless compute running the Rust MCP server
• Function URL: HTTP endpoint for direct access without API Gateway
• CORS Configuration: Cross-origin resource sharing for web clients
• ARM64 Architecture: Optimized for cost and performance on AWS Graviton processors

Deployment Stack

The infrastructure is defined in lib/rust-mcp-stack.ts and includes:

// Key infrastructure components:
- Runtime: PROVIDED_AL2023 (Amazon Linux 2023)
- Architecture: ARM_64 (AWS Graviton)
- Timeout: 30 seconds
- Memory: Default (128MB)
- Build Tool: cargo-zigbuild for cross-compilation

Build Process

The CDK stack handles cross-compilation from any platform to ARM64 Linux:

1. Local Bundling: Uses cargo-zigbuild for cross-compilation
2. Target: aarch64-unknown-linux-gnu for AWS Lambda ARM64
3. Binary: Creates a bootstrap executable for Lambda runtime
4. Deployment: Packages and deploys via CDK

CORS Configuration

cors: {
  allowedOrigins: ['*'],
  allowedMethods: [HttpMethod.GET, HttpMethod.POST, HttpMethod.PUT, HttpMethod.DELETE],
  allowedHeaders: ['Content-Type', 'Authorization', 'X-Requested-With'],
  maxAge: Duration.hours(1)
}

Prerequisites

• AWS CLI configured
• AWS CDK installed (npm install -g aws-cdk)
• Rust toolchain
• Zig compiler
• cargo-zigbuild (cargo install cargo-zigbuild)

Deployment Commands

# Install dependencies
npm install

# Build and deploy
cdk deploy

# Get the Function URL from outputs

🧠 Logic

MCP Protocol Implementation

The server implements the Model Context Protocol with full JSON-RPC 2.0 compliance:

Core Protocol Methods

1. Initialize: Establishes connection and returns server capabilities
2. Tools/List: Returns available tools for product search operations
3. Tools/Call: Executes specific tools with provided parameters

Available Tools

The server provides four main tools for product operations:

1. Search Products

{
  "name": "search_products",
  "description": "Search for products by name or keyword",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {"type": "string", "description": "Search query"},
      "limit": {"type": "integer", "description": "Max results (optional)"}
    },
    "required": ["query"]
  }
}

2. Filter by Price Range

{
  "name": "filter_by_price_range", 
  "description": "Filter products within a price range",
  "inputSchema": {
    "properties": {
      "min_price": {"type": "number", "description": "Minimum price"},
      "max_price": {"type": "number", "description": "Maximum price"}
    },
    "required": ["min_price", "max_price"]
  }
}

3. Search by Category

{
  "name": "search_by_category",
  "description": "Search products within a specific category", 
  "inputSchema": {
    "properties": {
      "category": {"type": "string", "description": "Product category"}
    },
    "required": ["category"]
  }
}

4. Get Categories

{
  "name": "get_categories",
  "description": "Retrieve all available product categories",
  "inputSchema": {"type": "object", "properties": {}}
}

Data Source

The server integrates with the DummyJSON API for product data:

• Products Endpoint: https://dummyjson.com/products
• Search Endpoint: `https://dummyjson.com/prod

... View full README on GitHub