Deterministic MCP Agents Course

A comprehensive course implementation for building production-ready MCP (Model Context Protocol) agents with deterministic finite state machines in Rust.

Repository Structure

.
├── modules/
│   ├── 01-foundations/    # Core concepts and theory
│   ├── 02-setup/         # Environment and toolchain
│   ├── 03-agents/        # Production agent patterns
│   ├── 04-mcp-server/    # MCP server implementation
│   └── 05-testing/       # Testing and QA strategies
├── final_project/        # Complete production system
├── pmcp/                # Shared MCP library
├── scripts/             # Automation and verification
└── docs/               # Course documentation

Quick Start

Prerequisites

• Rust 1.75+ (install from rustup.rs)
• PMAT 0.29.6+ with MCP feature
• Docker (optional, for containerization)

Installation

# Clone the repository
git clone https://github.com/paiml/deterministic-mcp-agents-course
cd deterministic-mcp-agents-course

# Install development dependencies
make install-dev

# Build all modules
make build

# Run tests
make test

# Check quality gates
make quality-gate-all

Course Modules

Module 1: Foundations (18:00)

• Course overview and performance baselines
• Certainty-Scope tradeoff demonstrations
• Floridi Conjecture implementation
• MCP protocol basics

Module 2: Environment Setup (18:00)

• Rust toolchain configuration
• PMAT installation and validation
• Quality gates implementation
• Calculator agent example

Module 3: Production Agents (23:00)

• FSM builder pattern
• Refactor state machine
• Code analysis FSM
• Error boundary implementation

Module 4: MCP Server (22:00)