Awesome-MCP-Learning
monirul8888/Awesome-MCP-Learning
A comprehensive repository for learning, building, and experimenting with Model Context Protocol (MCP) servers, including examples, tutorials, integrations, and best practices.
Instalação
npx convez-ai monirul8888/Awesome-MCP-Learning1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
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
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.