MCP 入門：教你嘅 AI 讀到全世界嘅資料
Model Context Protocol 係咩、點解 2026 年個個 AI 工具都用佢、由零寫一個 MCP server
AI 教學AI 生成
重點整理
- MCP 係咩：一個開放協議，令任何 AI 模型即插即用接駁檔案、資料庫、API 同工具
- 點解重要：以前每個 AI app 要逐個寫 integration，MCP 之後寫一次處處通行（USB-C 之於 AI）
- 實戰：用 Python SDK 由零寫一個 MCP server，30 行代碼令 Claude / Cursor 讀到你本地檔案
- 本地模型都用得：Ollama + MCP client，唔使雲端 API 一樣接工具
MCP 係咩？
**Model Context Protocol（MCP）**係 Anthropic 2024 年底開源、到 2026 年已經成為事實標準嘅開放協議。一句講晒：佢係 AI 世界嘅 USB-C——任何支援 MCP 嘅 AI 應用（Claude Desktop、Cursor、VS Code Copilot、Zed……）都可以即插即用接上任何 MCP server 提供嘅工具同資料。
以前你要令 AI 讀你嘅 Notion、你嘅資料庫、你嘅本地檔案，每個組合都要客製寫 integration。有咗 MCP，開發者只要寫一個 MCP server，全部 MCP client 就即刻用得。
三個核心概念
- Tools（工具）：AI 可以呼叫嘅函數——查天氣、跑 SQL、send email
- Resources（資源）：AI 可以讀取嘅資料——檔案、API 回應、資料庫記錄
- Prompts（提示模板）：預先包裝好嘅 prompt 範本
30 行寫一個 MCP Server（Python）
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("kc-notes")
@mcp.tool()
def read_note(name: str) -> str:
"""讀取本地筆記"""
with open(f"~/notes/{name}.md") as f:
return f.read()
@mcp.tool()
def list_notes() -> list[str]:
"""列出全部筆記"""
import glob, os
return [os.path.basename(p) for p in glob.glob(os.path.expanduser("~/notes/*.md"))]
if __name__ == "__main__":
mcp.run()
裝好 pip install "mcp[cli]"，喺 Claude Desktop 嘅 config 加返個 server 路徑，重啟之後你就可以直接問 AI「幫我列出我嘅筆記」——佢會自動呼叫你寫嘅工具。
本地模型都用得
唔想用雲端 API？Ollama 嘅 MCP client 生態 2026 年已經好成熟，用 ollama-mcp 之類嘅橋接工具，Qwen3.8 / GLM-5.2 呢啲本地模型一樣可以呼叫 MCP tools——離線環境都做到 Agent。
實用 tips
- 安全第一：MCP server 等於畀 AI 權限碰你嘅系統，只裝可信來源，寫 tool 時做輸入驗證
- 工具描述好重要：AI 靠 docstring 決定幾時用邊個工具，寫清楚「呢個工具做咩、幾時用」
- 由細做起：先寫一兩個工具解決自己真正嘅痛點，好過一開始砌個大平台
總結
MCP 已經係 2026 年 AI 應用生態嘅地基。學識寫一個 MCP server，你嘅 AI 助手就由「齋傾偈」升級成「真做得嘢」——而入場費只係 30 行 Python。