MCP 协议：AI Agent 工具集成的 USB-C 接口

USB-C 之于电子设备 = MCP 之于 AI 应用

USB-C：一个接口连接所有设备（显示器、存储、充电）
MCP：一个协议连接所有系统（数据库、API、文件系统）

┌─────────────────────────────────┐
│           MCP Server            │
├───────────┬───────────┬─────────┤
│  数据源    │   工具     │ 工作流   │
│ Resources │  Tools    │ Prompts │
├───────────┼───────────┼─────────┤
│ 本地文件   │ 搜索引擎   │ 提示词模板│
│ 数据库     │ 计算器     │ 工作流模板│
│ API 数据   │ 代码执行   │ Agent 技能│
└───────────┴───────────┴─────────┘

{
  "uri": "file:///project/src/main.py",
  "name": "主程序源码",
  "mimeType": "text/python"
}

{
  "name": "search_web",
  "description": "搜索互联网",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": { "type": "string", "description": "搜索关键词" }
    }
  }
}

┌─────────────┐    MCP 协议    ┌─────────────┐
│  MCP Client │ ←───────────→ │  MCP Server │
│  (AI 应用)   │               │  (工具/数据) │
└─────────────┘               └─────────────┘
     ↕                              ↕
┌─────────────┐               ┌─────────────┐
│    LLM      │               │  外部系统    │
│  (模型推理)  │               │ (DB/API/FS) │
└─────────────┘               └─────────────┘

from mcp.server import Server
from mcp.types import Tool, TextContent

server = Server("my-tools")

@server.list_tools()
async def list_tools():
    return [
        Tool(
            name="get_weather",
            description="获取天气信息",
            inputSchema={
                "type": "object",
                "properties": {
                    "city": {"type": "string", "description": "城市名"}
                },
                "required": ["city"]
            }
        )
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "get_weather":
        city = arguments["city"]
        weather = await fetch_weather(city)
        return [TextContent(type="text", text=weather)]

# 启动服务器
server.run(transport="stdio")

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["weather_server.py"],
      "env": { "API_KEY": "your-key" }
    }
  }
}

一个 Skill = 
  触发条件（什么时候用）
  + 执行步骤（怎么做）
  + 验证标准（怎么确认做对了）
  + 陷阱提示（常见错误）