Awesome MCP Learning

A beginner-friendly repository for learning the Model Context Protocol (MCP) using FastMCP and uv.

🚀 Environment

FastMCP version: 3.4.2
MCP version: 1.27.2
Python version: 3.14.3
Platform: Windows 11

📦 Prerequisites

• Python 3.14+

• Git

• uv

• FastMCP

Install uv:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verify installation:

uv --version

🛠️ Project Setup

Related MCP server: MCP Learning Project

Clone the Repository

git clone https://github.com/monirul8888/Awesome-MCP-Learning.git
cd Awesome-MCP-Learning

Create a Virtual Environment

uv venv

Activate the environment:

Windows PowerShell

.venv\Scripts\Activate.ps1

Linux/macOS

source .venv/bin/activate

Install Dependencies

uv sync

This installs all dependencies defined in pyproject.toml and locked in uv.lock.

▶️ Running the MCP Server

Run the server:

uv run python main.py

Or:

fastmcp run main.py

📁 Project Structure

Awesome-MCP-Learning/
│
├── main.py
├── pyproject.toml
├── uv.lock
├── requirements.txt
├── README.md
├── .gitignore
└── .python-version

🔄 Development Workflow

Install a new package:

uv add package-name

Example:

uv add fastmcp

Remove a package:

uv remove package-name

Update dependencies:

uv lock
uv sync

Run Python scripts:

uv run python main.py

🌿 Git Workflow

Initialize Git:

git init

Stage files:

git add .

Commit changes:

git commit -m "Initial MCP Project Server"

Add GitHub remote:

git remote add origin https://github.com/monirul8888/Awesome-MCP-Learning.git

Rename branch to main:

git branch -M main

Push to GitHub:

git push -u origin main

📚 Learning Goals

• Understand MCP fundamentals

• Build MCP servers with FastMCP

• Manage dependencies using uv

• Work with Git and GitHub

• Create reusable MCP tools and resources

👨‍💻 Author

Monirul Islam

GitHub: https://github.com/monirul8888

📄 License

This project is licensed under the MIT License.