davila7/mcp-courses

MCP Courses

A comprehensive collection of courses and tutorials for learning the Model Context Protocol (MCP) - an open protocol that standardizes how AI applications connect to external tools and data sources.

🎯 What is MCP?

The Model Context Protocol (MCP) enables AI models to connect with external data sources, tools, and environments, allowing for seamless transfer of information and capabilities between AI systems and the broader digital world. MCP transforms the complex M×N integration problem into a simple M+N solution by providing a standard interface.

Key Benefits:

• For Users: Simpler and more consistent experiences across AI applications
• For Developers: Easy integration with a growing ecosystem of tools and data sources
• For Tool Providers: Single implementation that works with multiple AI applications
• For Ecosystem: Increased interoperability, innovation, and reduced fragmentation

📚 Course Structure

🚀 Deep Learning Course

Status: ✅ Available

A comprehensive course covering MCP implementation with practical examples using Streamlit, Wikipedia, and arXiv integrations.

Course Contents:

📖 Fundamentals & Tool Integration

• 3_streamlit_tool_use_arxiv.py - Streamlit app with arXiv paper search functionality
• 3_arxiv_mcp_server.py - MCP server for arXiv paper search and information extraction
• 4_streamlit_tool_use_wikipedia.py - Streamlit app with Wikipedia integration
• 4_wikipedia_mcp_server_sse.py - Wikipedia MCP server with SSE transport
• 4_wikipedia_mcp_server_stdio.py - Wikipedia MCP server with STDIO transport

🔗 MCP Client Implementation

• 5_mcp_client.py - Basic MCP client implementation
• 5_streamlit_mcp_client.py - Streamlit interface for single MCP server connection
• 6_streamlit_mcp_client_multiple.py - Advanced multi-server MCP client with Streamlit UI

🌐 Advanced Server Implementations

• 7_wikipedia_mcp_server_stdio_prompts_resources.py - Full-featured Wikipedia server with prompts and resources
• 7_wikipedia_mcp_client_prompts_resources_stdio.py - Client for advanced Wikipedia server
• 7_wikipedia_mcp_server_prompts_resources_sse copy.py - SSE version with prompts and resources
• 7_wikipedia_mcp_server_prompts_resources_streamable-http.py - HTTP streamable version (Production recommended)

Key Features Covered:

• Transport Protocols: STDIO, SSE, and Streamable HTTP
• Tool Integration: Search, content retrieval, and data processing
• Multi-Server Architecture: Connect to multiple MCP servers simultaneously
• Interactive UI: Streamlit-based chat interfaces
• Resource Management: Prompts, tools, and resources handling
• Game Generation: Interactive educational content creation

Configuration:

• server_config.json - Multi-server configuration file
• Pre-configured data directories for papers and wiki articles

📊 DataCamp Course

Status: 🔄 Coming Soon

Advanced data science and analytics integration with MCP protocol.

🤗 Hugging Face Course

Status: 🔄 Coming Soon

Machine learning model integration and deployment using MCP with Hugging Face ecosystem.

🚀 Getting Started

Prerequisites

• Python 3.8+
• Node.js (for filesystem server)
• UV package manager (recommended)

Installation

1. Clone the repository:

git clone https://github.com/davila7/mcp-courses.git
cd mcp-courses
pip install -r requirements.txt

2. Install dependencies:

pip install -r requirements.txt

3. Set up environment variables:

# Copy and configure your API keys
cp .env.example .env
# Edit .env with your API keys (Anthropic, Brave Search, etc.)

Quick Start - Deep Learning Course

1. Run a basic MCP server:

# Start Wikipedia MCP server with STDIO
python deeplearning_course/4_wikipedia_mcp_server_stdio.py

2. Launch Streamlit client:

# Single server client
streamlit run deeplearning_course/5_streamlit_mcp_client.py

# Multi-server client (recommended)
streamlit run deeplearning_course/6_streamlit_mcp_client_multiple.py

3. Configure servers:

• Edit deeplearning_course/server_config.json to add your server configurations
• The multi-server client supports filesystem and Wikipedia servers out of the box

🏗️ Architecture Overview

Transport Protocols Supported:

• STDIO: Direct process communication (development)
• SSE: Server-Sent Events over HTTP (web applications)
• Streamable HTTP: Modern HTTP with bidirectional streaming (production recommended)

Core Components:

• MCP Servers: Expose tools, resources, and prompts
• MCP Clients: Connect to servers and manage communication
• Streamlit UIs: Interactive web interfaces for testing and demonstration
• Configuration Management: JSON-based server configuration

📖 Learning Path

1. Start with Tool Integration (3_*.py files)

• Learn basic tool calling with Streamlit
• Understand arXiv and Wikipedia API integration

2. Explore MCP Servers (4_*.py files)

• Implement MCP servers with different transport protocols
• Compare STDIO vs SSE implementations

3. Build MCP Clients (5_.py and 6_.py files)

• Create single and multi-server clients
• Master session management and tool orchestration

4. Advanced Features (7_*.py files)

• Implement prompts and resources
• Build production-ready servers with Streamable HTTP

Project Structure:

mcp-courses/
├── deeplearning_course/           # Complete MCP course materials
│   ├── papers/                    # arXiv paper storage
│   ├── wiki_articles/             # Wikipedia article cache
│   └── server_config.json         # Multi-server configuration
├── main.py                        # Repository entry point
├── requirements.txt               # Python dependencies
└── pyproject.toml                 # Project configuration

Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is open source and available under the MIT License.

🔗 Resources

• MCP Official Documentation: Model Context Protocol
• Anthropic Tool use: Tool use Documentation
• Anthropic MCP Guide: MCP Documentation