更加优雅的类型检查与传参---mcp源码分析

复制代码
def run(self, transport= "stdio", **kwargs):
    ...

我们如果要实现一个函数适配多个不同的入口,传统方法就是这样子做,定义一个入口函数,设置动态传入参数。

但这种方法简直是灾难,

1.不管选哪个 transport,都会一次性弹出 host、port、sse_path、json_response 等全部几十种参数,分不清哪个参数属于哪种传输方式,极易传错。

2.某个模式根本不需要其他参数,但类型检查器不会报错,运行时多余参数丢进 kwargs,底层函数不识别就会静默异常,调试极难。

如果想要更加优雅的类型检查与传参,python还提供了另外一种方式给我们使用,

复制代码
@overload
def run(self, transport: Literal["stdio"] = ...) -> None: ...

@overload
def run(
    self,
    transport: Literal["sse"],
    *,
    host: str = ...,
    port: int = ...,
    ...
) -> None: ...

def run(
    self,
    transport: Literal["stdio", "sse", "streamable-http"] = "stdio",
    **kwargs: Any,
) -> None:
    # 路由分发逻辑

重载 1:transport="stdio"

  • 只能传 transport="stdio",不允许额外关键字参数(host/port 等都不能传);
  • IDE 调用 server.run() 时不会弹出 host、port 等多余参数,类型检查器多传参数直接标红报错。

重载 2:transport="sse"

  • 必须显式指定 transport="sse";
  • *, 强制后续所有参数只能用关键字传参,不能位置传参;
  • 限定只能传入 SSE 专属配置:host、port、sse_path、证书配置等,其它无关参数静态报错。

def run(是唯一真实实现函数(运行时真正执行)

相关推荐
好用斋3 分钟前
拾光坞G2使用新版Docker懒人包:一键安装、一键升级、一键卸载
java·docker·容器
码云社区20 分钟前
Spring Boot陪诊陪护系统源码:医院目录、服务项目与城市业务配置
java·spring boot·后端·陪诊陪护·医院陪诊·医院陪护·陪护小程序
Rabitebla27 分钟前
【Linux】文件篇(六):Shell 实战——从系统调用到命令行重定向
linux·服务器·c++·笔记·学习
Evand J34 分钟前
【MATLAB例程】基于APF的多无人机动态路径规划与避障仿真。避碰及安全性能分析。附完整代码的下载链接
开发语言·matlab·无人机
鲸渔1 小时前
【AI Agent系列课程13-Python 基础13】JSON 读写:结构化数据交换基础
开发语言·python·json·ai编程
CoderYanger2 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第七弹):图书管理系统(强制登录)
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
学长毕设2 小时前
基于SpringBoot 餐饮餐厅点菜管理系统-附源码
java·spring boot·后端
学长毕设2 小时前
基于SpringBoot 校园招聘求职论坛交流系统-附源码
java·spring boot·后端
Highcharts.js6 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图
武昌库里写JAVA10 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai