Learning MCP tools, resources, and prompts with server–client architecture using STDIO and HTTP (SSE) transports.
概览
A hands-on learning repository that teaches the from scratch. Each file demonstrates a core MCP concept — , , , , and — with real, runnable code. is an open standard created by Anthropic that lets AI models (like Claude, GPT, etc.) connect to through a unified protocol. Think of it like a — just as USB lets any device connect to any computer, MCP lets any AI connect to any tool or data source. Tools are the AI can call. Think of them as API endpoints the AI can invoke. Resources are the AI can access. Like reading a file or fetching a config. Prompts are with dynamic arguments. They guide the AI's behavior. This file shows the — one tool, one transport, ready to go. This file is the version of the tool server with detailed comments and examples.
README
以下为原文 README 节选,完整内容请查看原文。
🔌 Learning MCP (Model Context Protocol)
Tools, Resources, and Prompts with Server–Client Architecture using STDIO & HTTP (SSE) Transports
A hands-on learning repository that teaches the Model Context Protocol (MCP) from scratch. Each file demonstrates a core MCP concept — Tools, Resources, Prompts, Transports, and Client Integration — with real, runnable code.
📖 Table of Contents
- What is MCP?
- How MCP Works — The Big Picture
- Core Concepts
- Project Structure
- Getting Started
- File-by-File Code Walkthrough
- Transport Types Explained
- Important: console.log vs console.error
- Old API vs New API
- Architecture Patterns
- Tech Stack
- License
🧠 What is MCP?
MCP (Model Context Protocol) is an open standard created by Anthropic that lets AI models (like Claude, GPT, etc.) connect to external tools, data sources, and prompt templates through a unified protocol.
Think of it like a USB port for AI — just as USB lets any device connect to any computer, MCP lets any AI connect to any tool or data source.
Without MCP
User → AI Model → ❌ Can't access external tools, APIs, databases
With MCP
User → AI Model → MCP Client → MCP Server → ✅ Tools, Data, APIs, Databases
🏗 How MCP Works — The Big Picture
┌──────────────────────────────────────────────────────────────────┐
│ USER / AI HOST │
│ (Claude Desktop, VS Code Copilot, Custom Chatbot, etc.) │
│ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ MCP Client │ │ MCP Client │ │ MCP Client │ │
│ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ │
│ │ │ │ │
└─────────┼──────────────────┼──────────────────┼──────────────────┘
│ STDIO │ STDIO │ HTTP/SSE
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ MCP Server │ │ MCP Server │ │ MCP Server │
│ (Tools) │ │ (Resources) │ │ (Prompts) │
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →