快乐冲浪与生活

async/await 是基于 Promise、以同步方式编写异步代码的语法糖。

简单来说：

async 放置在函数定义前，函数总是返回一个 Promise，返回值会自动包裹在已解析的 Promise 中。

Mosquitto 是 MQTT 的开源实现之一，GitHub 地址 https://github.com/eclipse-mosquitto/mosquitto ，介绍信息如下：

Mosquitto is an open source implementation of a server for version 5.0, 3.1.1, and 3.1 of the MQTT protocol. It also includes a C and C++ client library, the mosquitto_pub mosquitto_rr, and mosquitto_sub utilities for publishing and subscribing, and the mosquitto_ctrl, mosquitto_signal, and mosquitto_passwd applications for helping administer the broker.

MQTT 是什么

MQTT（Message Queuing Telemetry Transport，消息队列遥测传输）是一种轻量级、基于发布 / 订阅（Pub/Sub）模式的应用层网络协议，专为低带宽、高延迟、不稳定的网络环境（如物联网、嵌入式设备）设计。

• 学习资料： https://zod.dev/api
• 辅助：豆包
• Zod 版本：4

Zod 中定义的 Record 对应着 TS 中的 Record，用于构建键值对。

1
2
3
4
5
6
7
8

import * as z from 'zod'

const StudentSchema = z.record(z.string(), z.string())
type Student = z.infer<typeof StudentSchema>

// 等价于

type Student = Record<string, string>

JSON 和对象

TS 中 Record 与 JSON 和对象相似，对应的概念如下：

• 学习资料： https://zod.dev/api
• 辅助：豆包
• Zod 版本：4

模式，也就是数据结构，使用 Zod 时，我们要先定义模式，即定义数据结构的规则，然后调用 .parse 或 safeParse 进行校验。

开发环境的搭建

本节要搭建一个能运行 Zod 库的 TypeScript 开发环境，步骤如下：

• 学习资料： https://zod.dev/
• 辅助：豆包
• Zod 版本：4

学习一个新的技术、框架或包，首先要解决的是事物的三个问题：

• 是什么
• 做什么
• 有什么

本文就是围绕 Zod 回答上面的三个问题，并在后续的文章中介绍“怎么用”。

• 学习来源： https://modelcontextprotocol.io/docs/develop/build-server
• 目标：构建一个“天气查询”的 MCP Server
• 编程语言：Python
• 天气接口文档： https://uapis.cn/docs/api-reference/get-misc-weather

前提条件

• Python 的开发环境
• MCP 主机（我使用的是 Cherry Studio）

注意事项

根据实现的 MCP Server 的类型不同，做日志功能时需要注意：

本文继续做官方文档的学习和摘录，在服务器和客户端这一块，理解有效，有些翻译甚至有些勉强。

学习来源：

1. https://modelcontextprotocol.io/docs/learn/server-concepts
2. https://modelcontextprotocol.io/docs/learn/client-concepts

服务端

MCP servers are programs that expose specific capabilities to AI applications through standardized protocol interfaces.