Skip to content

Samples & Tutorials

Learn MCP through hands-on examples and step-by-step tutorials. Each sample is designed to teach specific concepts while building something practical.

Quick Start Tutorials

🚀 Hello MCP

5 minutes • Beginner

Build your first MCP server that responds to simple requests. Perfect starting point for newcomers.

Start Tutorial →

🛡️ Security Monitoring

25 minutes • Intermediate

Integrate AI-powered security monitoring with Wazuh SIEM for threat detection and incident response.

Start Tutorial →

🔥 Network Security

30 minutes • Advanced

Build intelligent network security management with pfSense firewall integration and automated threat mitigation.

Start Tutorial →

🗄️ Database Connector

15 minutes • Intermediate

Create an MCP server that safely exposes database queries to AI assistants.

Start Tutorial →

⚡ Function Calling

20 minutes • Intermediate

Enable AI models to execute cloud functions and APIs through MCP.

Start Tutorial →

🔄 Streaming Updates

25 minutes • Advanced

Implement real-time data streaming with WebSocket transport.

Start Tutorial →

📱 Mobile Integration

30 minutes • Advanced

Build a React Native app that connects to MCP servers.

Start Tutorial →

Learning Path

🎯 For Beginners

  1. Start with Hello MCP - Understand the basics
  2. Try Database Connector - Work with real data
  3. Explore our FAQ - Get answers to common questions

🚀 For Developers

  1. Review Function Calling - Integrate existing APIs
  2. Master Streaming Updates - Handle real-time data
  3. Check Implementation Guides - Production best practices

🏗️ For Architects

  1. Study all samples - Understand patterns
  2. Read Protocol Specification - Deep technical details
  3. Review Use Cases - Real-world applications

What You'll Build

Each tutorial results in a working MCP implementation:

Tutorial You'll Build Key Concepts
Hello MCP Echo server with tools Basic protocol, tool definition
Database Connector SQL query interface Security, resource management
Function Calling API gateway Tool parameters, error handling
Streaming Updates Live data feed WebSocket, subscriptions
Mobile Integration React Native client Client implementation, UI

Prerequisites

General Requirements

  • Basic programming knowledge (Python or TypeScript)
  • Command line familiarity
  • Text editor or IDE

Language-Specific Setup

# Python 3.8 or higher
python --version

# Install MCP SDK
pip install mcp

# Node.js 16 or higher
node --version

# Install MCP SDK
npm install @modelcontextprotocol/sdk

Running the Samples

All samples follow the same pattern:

  1. Clone the sample code
  2. Install dependencies
  3. Run the server
  4. Test with a client

Each tutorial includes: - ✅ Complete source code - ✅ Step-by-step explanations - ✅ Common pitfalls to avoid - ✅ Extension ideas - ✅ Links to run in online environments

Online Playgrounds

Don't want to install anything? Try MCP in your browser:

Contributing Samples

Have a great MCP example? We welcome contributions:

  1. Fork our repository
  2. Add your sample following our template
  3. Include clear documentation
  4. Submit a pull request

Pro Learning Tips

  • Type everything - Don't copy/paste, build muscle memory
  • Experiment - Modify the samples and see what happens
  • Break things - Understanding errors deepens knowledge
  • Ask questions - Our community is here to help

Ready to start? Jump into Hello MCP →