FastMCP 安装配置快速上手：用 Python 跑起你的第一个 MCP 服务器
【免费下载链接】fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.项目地址: https://gitcode.com/GitHub_Trending/fa/fastmcp
FastMCP 安装本身很轻量：只要 Python 环境就位，几分钟就能完成 FastMCP 配置并实现 MCP 服务器的 Python 快速部署。这份上手笔记面向 Python 初学者、刚接触 Model Context Protocol（MCP）的开发者，也适合想把自有数据或工具接进 LLM 应用的人——跳过概念铺垫，直接给出一条"建一个文件、跑起来、能验证"的最短路径。
FastMCP 解决什么问题
FastMCP 是一个用于构建 MCP 服务器的 Python 框架。MCP 是 LLM 与外部工具、数据之间的连接协议；如果直接基于协议写服务器，你得自己处理 schema 生成、参数校验、传输协商和认证等细节。用 FastMCP 之后，把一个普通 Python 函数加一个装饰器，它就能作为"工具"暴露给 LLM 应用；一段数据加一个资源声明，就成了可被模型读取的"资源"。schema、校验、文档说明都由框架自动生成。底层技术栈（Pydantic 负责数据验证、HTTPX 负责异步 HTTP）在后台默默工作，新手不必深入了解。
先检查 Python 环境
| 检查项 | 要求 | 说明 |
|---|---|---|
| Python | 3.10 及以上 | 老教程写的 3.7+ 已不成立，最新 FastMCP 要求 3.10；用python --version确认 |
| pip | 任意较新版本 | 包管理器，用于安装 fastmcp |
| uvicorn | ≥ 0.35 | HTTP 传输时作为底层 ASGI 服务器，安装 fastmcp 时会自动带进来，无需手动装 |
最快安装路径
pip install fastmcp fastmcp version第二条命令能打印出版本号、MCP 版本和平台信息，就说明安装成功。习惯用 uv 管理项目的同学，等价的写法是uv add fastmcp。
写一个最小可用的服务器
建一个工作目录，放入server.py：
from fastmcp import FastMCP mcp = FastMCP("My First Server") @mcp.tool def add(a: int, b: int) -> int: """两个整数相加""" return a + b @mcp.resource("hello") def hello() -> str: return "Hello, MCP" if __name__ == "__main__": mcp.run(transport="http", port=8000)三个要点：FastMCP("名称")创建服务器实例，名称会展示给客户端；@mcp.tool把函数注册为工具，参数 schema 直接从函数签名推导；@mcp.resource("hello")把一段数据注册为资源。
启动并验证服务
python server.py # 或使用内置 CLI，效果相同： fastmcp run server.py --transport http --port 8000启动后终端会打印监听信息，协议端点是http://127.0.0.1:8000/mcp。验证不用手写请求：fastmcp dev inspector server.py会打开浏览器版的 MCP Inspector，可以直接看到注册好的工具，手动调用add并查看返回值——这是最直观的 MCP 服务器入门验证方式。
常见坑速查
| 现象 | 原因与处理 |
|---|---|
升级后import fastmcp报找不到模块 | pip 升级残留了半成品安装，执行pip install --force-reinstall fastmcp |
| 浏览器打开 8000 端口报错 | /mcp端点是 JSON-RPC 接口，不是普通网页，请用 Inspector 或客户端验证 |
| 端口被占用 | 用--port 9000换一个端口，命令行参数优先于代码内配置 |
照着老教程执行uvicorn server:app跑不起来 | 新版 FastMCP 自己管理 HTTP 层（内部已依赖 uvicorn），不需要手动配置 ASGI 入口 |
下一步扩展方向
服务跑通后，按顺序尝试三件事：
- 接一个真实客户端：用
Client("http://localhost:8000/mcp")在 Python 里直接调用工具，完整流程见 quickstart 文档； - 了解部署细节：传输选项、认证与生产环境配置，见 安装配置文档 和 HTTP 部署文档；
- 读源码：服务器实现在 fastmcp_slim/fastmcp/server/，从装饰器与工具注册逻辑入手最容易看懂全貌。
建议把add替换成你的真实业务函数——查本地文件、调自有接口都算——再接入一个支持 MCP 的客户端，你就拥有了一个真正在用的 MCP 服务器。
【免费下载链接】fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.项目地址: https://gitcode.com/GitHub_Trending/fa/fastmcp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
