SuperAPI AI 工具集

fastmcp-server

智能体与模型

查看项目

更新于 10-15 20:34

技能介绍

用途:本技能是使用 FastMCP 3.0(面向 Python 的 MCP 服务器框架)构建生产级 MCP 服务器的完整参考,帮助把 LLM 连接到工具与数据。适用时机包括:用 Python 新建 MCP 服务器、为服务器添加工具/资源/提示词、实现认证(OAuth、OIDC、令牌校验)、配置中间件(日志、限流、授权)、配置提供者、构建带遥测与存储的生产服务器,以及从 FastMCP 2.x 升级到 3.0。

主要能力:核心部分覆盖工具与资源(装饰器、校验、返回类型、模板)以及上下文与依赖注入(MCP 上下文、后台任务)。安全部分涵盖认证(OAuth、OIDC、令牌校验、代理模式)与授权(基于作用域和角色的访问控制)。高级部分包括中间件(请求/响应管线、内置中间件)、提供者(本地、文件系统、技能、自定义)、以及分页、采样、存储、OpenTelemetry、版本管理等功能。

使用方式:用 from fastmcp import FastMCP 创建实例,通过 @mcp.tool、@mcp.resource、@mcp.prompt 等装饰器注册组件,用 mcp.run() 启动,也可指定传输方式,如 mcp.run(transport="sse", host="0.0.0.0", port=8000)。工具中可注入 Context 以记录日志、上报进度和读取资源。认证可配置 BearerAuthProvider,传入 jwks_uri、audience、issuer 等参数。依赖注入使用 Depends()。文档还按 getting-started、server、context、features、authentication、authorization、providers 等目录组织参考文件。

适用场景与限制:适合需要以标准化协议向 LLM 暴露工具与数据的 Python 项目。本资料为技能说明与参考索引,具体安装命令、依赖清单、部署步骤与完整 API 细节暂未提供;版本历史标注 v1.0.0(2026 年 2 月),覆盖 FastMCP 3.0 候选版本。