A Model Context Protocol (MCP) server providing context, tools, and integrations for AI models.
概览
A growing collection of , each built to explore a different real-world use case — from simple utilities to database-connected agents and DevOps automation. Every module lives in its own numbered folder and is a complete, runnable MCP server on its own. This repo is where I learn MCP by building it: one server at a time, each one a little more advanced than the last. The Model Context Protocol is an open standard that lets AI applications (like Claude, Cursor, or any MCP-compatible client) connect to external tools, data, and systems in a consistent way — through (actions the AI can perform), (data the AI can read), and (reusable instructions). Click here for the notes: https://heather-aura-1c8.notion.site/MCP-Complete-Beginner-Notes-3d84003352778003b141fee8d602ebc9?pvs=74 Each module is self-contained with its own README.md explaining what it does and how to run it. New modules will be added as 04_..., 05_...
README
以下为原文 README 节选，完整内容请查看原文。
🔌 MCP — Model Context Protocol Servers
A growing collection of Model Context Protocol (MCP) servers, each built to explore a different real-world use case — from simple utilities to database-connected agents and DevOps automation. Every module lives in its own numbered folder and is a complete, runnable MCP server on its own.
This repo is where I learn MCP by building it: one server at a time, each one a little more advanced than the last.
🧠 What is MCP?
The Model Context Protocol is an open standard that lets AI applications (like Claude, Cursor, or any MCP-compatible client) connect to external tools, data, and systems in a consistent way — through Tools (actions the AI can perform), Resources (data the AI can read), and Prompts (reusable instructions).
Click here for the notes: https://heather-aura-1c8.notion.site/MCP-Complete-Beginner-Notes-3d84003352778003b141fee8d602ebc9?pvs=74
📂 Repository Structure
mcp/
├── 01_simple_math/ ✅ Calculator MCP server (FastMCP)
├── 02_expense_tracker/ ✅ PostgreSQL-backed expense tracker (22 tools)
├── 03_github_mcp/ ✅ GitHub MCP server (30 tools)
├── pyproject.toml
├── pyrightconfig.json
├── uv.lock
└── .gitignore
Each module is self-contained with its own README.md explaining what it does and how to run it. New modules will be added as 04_..., 05_..., and so on — this repo will keep growing as I explore new kinds of MCP servers.
📖 Modules
✅ 01_simple_math — Calculator MCP Server
A calculator MCP server built with FastMCP, demonstrating all three core MCP primitives:
| Primitive | Examples |
|---|---|
| Tools | add, subtract, multiply, divide, percentage |
| Resources | calculator://about, calculator://operations, calculator://examples |
| Prompts | solve_math_problem, explain_calculation, check_calculation |
✅ 02_expense_tracker — Expense Tracker MCP Server
A PostgreSQL-backed personal finance assistant — full CRUD on expenses, search/filter, monthly and category analytics, budgets, recurring expenses, multi-currency support, natural-language dates, and statistical anomaly detection. 22 tools, 5 resources, 2 prompts, with a documented three-round QA pass (90+ manually-run scenarios).
📄 Read the module README · Testing notes
✅ 03_github_mcp — GitHub MCP Server
Read and write access to GitHub — repositories, files, commits, branches,
pull requests, issues, code review comments, and GitHub Actions — through
the GitHub REST and Git Data APIs. 30 tools split across dedicated
read/update/create files so a bug in a read operation can never
accidentally become a write, including real atomic multi-file commits
(push_files, via the low-level Git Data API — the same primitives
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →