convez.ai
MCP Server
monirul8888

Awesome-MCP-Learning

monirul8888/Awesome-MCP-Learning

Ver no GitHub
InicialPluginScore · de 0 a 100

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-Learning

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

Ver o original no GitHub

Bom para

Relacionados