🔧 Simple Code Review Assistant - MCP Assignment

Assignment Duration: 6-8 Hours
Target Audience: Intermediate Level Developers
Focus: Model Context Protocol (MCP) Basics

🎯 Learning Objectives

By completing this assignment, you will:

• Build a basic MCP server using Model Context Protocol

• Implement simple tool interfaces for AI models

• Practice GitHub API integration

• Understand how AI models connect to external data sources

📋 Prerequisites

• Python 3.11+ experience

• Basic understanding of REST APIs

• Familiarity with GitHub API

• Basic knowledge of AI/LLM concepts

🚀 Quick Start

1. Environment Setup

2. Configuration

Create .env file in the project root:

3. Run the MCP Server

📁 Project Structure

🏗️ System Architecture

MCP Tools (Keep it Simple!)

Simple Flow

📋 Core Requirements (Simplified)

Must-Have Features (6-8 hours scope)

1. Basic MCP Server

   • Implement ONE MCP server file (server.py)

   • Support 3 simple tools (listed above)

   • Follow basic MCP protocol

   • Handle errors gracefully

2. GitHub Integration

   • Connect to GitHub API using token

   • Implement get_repository tool

   • Implement get_file_content tool

   • Add basic rate limiting

3. Documentation Search

   • Implement search_docs tool for local files

   • Search through markdown files in /docs folder

   • Return relevant file content

   • Support simple keyword matching

4. Simple Client

   • Create client.py to test your MCP server

   • Demonstrate all 3 tools working

   • Show real GitHub data retrieval

   • Display search results

🔧 Implementation Steps

Step 1: Setup

Step 2: Basic MCP Server

• Implement MCP protocol basics

• Add the 3 required tools

• Test with simple responses

Step 3: GitHub Integration

• Connect to GitHub API

• Implement repository and file tools

• Add error handling

Step 4: Documentation Search

• Create simple file search

• Add sample documentation files

• Test search functionality

Step 5: Client & Testing

• Build simple client

• Test all tools

• Create demo

📝 Submission Requirements (Minimal)

Required Files

• ✅ server.py - Working MCP server

• ✅ client.py - Simple test client

• ✅ requirements.txt - Dependencies

• ✅ .env.example - Environment template

• ✅ Sample docs in /docs folder

Demo Requirements

• ✅ Show MCP server starting up

• ✅ Demonstrate GitHub repository access

• ✅ Show documentation search working

• ✅ Explain your implementation approach

🔗 Resources

• MCP Python SDK

• GitHub REST API Documentation

• MCP Examples

🔧 Development Commands