当前位置：首页 > news >正文

Python使用FastMCP开发MCP服务端

news 来源：原创 2025/8/26 15:15:40

MCP简介

Model Context Protocol (MCP) 是一个专门为 LLM（大语言模型）应用设计的协议，它允许你构建服务器以安全、标准化的方式向 LLM 应用程序公开数据和功能。FastMCP 作为 Python 生态中的一款轻量级框架，利用装饰器来简化路由与工具函数的开发，帮助开发者快速构建面向工具的服务端应用。

MCP Server 提供了 3 种核心原语，每种原语都有其特定的用途和特点：

1. Tool（工具）：

Tool 允许服务器公开可执行的函数，这些函数可由客户端调用并由 LLM 使用来执行操作。Tool 不仅人让 LLM 能从外部获取信息，还能执行写入或操作，为 LLM 提供真正的行动力。
模型控制：Tool 直接暴露给 LLM 可执行函数，让模型可以主动调用。

2. Resource（资源）：

Resource 表示服务器希望提供给客户端的任何类型的只读数据。这可能包括：文件内容、数据库记录、图片、日志等等。
应用控制：Resource 由客户端或应用管理，用于为 LLM 提供上下文内容。

3. Prompt（提示模板） ：

Prompt 是由服务器定义的可重用的模板，用户可以选择这些模板来引导或标准化与 LLM 的交互过程。例如，Git MCP Server 可以提供一个“生成提交信息”的提示模板，用户可以用它来创建标准化的提交消息。
用户控制：Prompt 通常由用户自行选择。

MCP概述

MCP服务端当前支持两种与客户端的数据通信方式：标准输入输出(stdio) 和基于Http的服务器推送事件(http sse)

标准输入输出(stdio)

原理： 标准输入输出是一种用于本地通信的传输方式。在这种模式下，MCP 客户端会将服务器程序作为子进程启动，双方通过约定的标准输入和标准输出（可能是通过共享文件等方法）进行数据交换。具体而言，客户端通过标准输入发送请求，服务器通过标准输出返回响应。
适用场景： 标准输入输出方式适用于客户端和服务器在同一台机器上运行的场景（本地自行编写服务端或将别人编写的服务端代码pull到本地执行），确保了高效、低延迟的通信。这种直接的数据传输方式减少了网络延迟和传输开销，适合需要快速响应的本地应用。

基于Http的服务器推送事件(http sse)

原理: 客户端和服务端通过 HTTP 协议进行通信，利用 SSE 实现服务端向客户端的实时数据推送，服务端定义了/see与/messages接口用于推送与接收数据。这里要注意SSE协议和WebSocket协议的区别，SSE协议是单向的，客户端和服务端建立连接后，只能由服务端向客户端进行消息推送。而WebSocket协议客户端和服务端建立连接后，客户端可以通过send向服务端发送数据，并通过onmessage事件接收服务端传过来的数据。

适用场景： 适用于客户端和服务端位于不同物理位置的场景，尤其是对于分布式或远程部署的场景，基于 HTTP 和 SSE 的传输方式更合适。如：Prometheus，MySQL，MongoDB 数据库等等

环境介绍

uv快速构建Python环境

Win打开 powershell 进行安装
参考文档：https://docs.astral.sh/uv/getting-started/installation/#standalone-installer

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"# With pip.
pip install uv

安装之后，可以通过uv help命令检查是否安装成功：
在这里插入图片描述

卸载

powershell -c "irm https://astral.sh/uv/install.ps1 | more"

基本使用方法

# 创建项目文件夹、同时初始化并指定python版本
uv init py-app -p 3.11.9
# 创建并激活虚拟环境
uv venv
source .venv/bin/activate# 退出虚拟环境
deactivate
uv venv --seed  # 强制安装基础包（如pip, setuptools, wheel）# 同步依赖
uv sync
# 安装 requirements.txt
uv pip install -r requirements.txt# 安装包（使用清华源）
cd py-app
uv add pandas pillow --default-index "https://pypi.tuna.tsinghua.edu.cn/simple"# 安装CUDA版的torch（使用南京大学源）
uv pip install torch torchvision torchaudio --index-url https://mirror.nju.edu.cn/pytorch/whl/cu126# 执行python
uv run app.py

Python版本的安装和管理

# 显示当前已经安装的和可供安装的Python版本
uv python list# 安装指定的Python版本（注意：安装的Python并非全局可用，在命令行工具中输入Python无反映）
uv python install 3.10 3.11 3.12# 卸载指定的版本
uv python uninstall 3.10

https://www.cnblogs.com/wang_yb/p/18635441

https://zhuanlan.zhihu.com/p/1888904532131575259

版本推荐

Python 版本： 推荐使用 Python 3.10 及以上版本，以便更好地支持异步函数（async/await）我的版本：Python 3.14

FastMCP 库： 该库需要通过 pip 或其他方式安装。安装指令如下：

pip install fastmcp

运行方式： 本示例采用标准输入/输出（stdio）作为传输层，可根据实际需求选择其他传输方式，如网络通信等。

实现步骤

下面按照步骤解析如何构建一个简单但功能完备的 MCP 服务端：

stdio

from mcp.server.fastmcp import FastMCPmcp = FastMCP("Demo 🚀")@mcp.tool()
def add(a: int, b: int) -> int:"""两个数字相加"""return a + b@mcp.tool()
async def calculate(expression: str) -> str:"""计算一个简单的数学表达式。Args:expression: 要计算的数学表达式（如"1 + 2"）Returns:str: 计算结果"""try:result = eval(expression)return f"计算结果: {result}"except Exception as e:return f"计算错误: {str(e)}"@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:"""获取个性化问候语"""return f"Hello, {name}!"if __name__ == "__main__":mcp.run(transport='stdio')

启动调试：

mcp dev main.py

在这里插入图片描述

错误报错：

Created web app transport
Created web app transport
Set up MCP proxy
file:///C:/Users/admin/AppData/Local/npm-cache/_npx/5a9d879542beca3a/node_modules/@modelcontextprotocol/sdk/dist/esm/server/sse.js:103throw new Error("Not connected");^Error: Not connectedat SSEServerTransport.send (file:///C:/Users/admin/AppData/Local/npm-cache/_npx/5a9d879542beca3a/node_modules/@modelcontextprotocol/sdk/dist/esm/server/sse.js:103:19)at Socket.<anonymous> (file:///C:/Users/admin/AppData/Local/npm-cache/_npx/5a9d879542beca3a/node_modules/@modelcontextprotocol/inspector/server/build/index.js:101:33)at Socket.emit (node:events:517:28)at addChunk (node:internal/streams/readable:368:12)at readableAddChunk (node:internal/streams/readable:341:9)at Readable.push (node:internal/streams/readable:278:10)at Pipe.onStreamRead (node:internal/stream_base_commons:190:23)

解决方案：

npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-memory
npm install -g @modelcontextprotocol/server-brave-search

sse模式

from mcp.server.fastmcp import FastMCPmcp = FastMCP("Demo 🚀")@mcp.tool()
def add(a: int, b: int) -> int:"""两个数字相加"""return a + b@mcp.tool()
async def calculate(expression: str) -> str:"""计算一个简单的数学表达式。Args:expression: 要计算的数学表达式（如"1 + 2"）Returns:str: 计算结果"""try:result = eval(expression)return f"计算结果: {result}"except Exception as e:return f"计算错误: {str(e)}"@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:"""获取个性化问候语"""return f"Hello, {name}!"if __name__ == "__main__":mcp.run(transport='sse')

在 FastMCP 中，有几个可以设置 SSE 协议相关的参数：

host: 服务地址，默认为 0.0.0.0
port: 服务端口，默认为 8000。上述代码中，我设置为 9000
sse_path：sse 的路由，默认为 /sse

Vscode-Cline调用

安装Vscode和Cline

在这里插入图片描述

stdio模式调用

{"mcpServers": {"weather": {"command": "uv","args": ["--directory","E:\\Code\\Python\\weather","run","main.py"],"timeout": 30}}
}

在这里插入图片描述

sse模式

在这里插入图片描述

{"mcpServers": {"weather": {"url": "http://192.168.96.19:8000/sse"}}
}

在这里插入图片描述

参考文档：
https://github.com/GobinFan/python-mcp-server-client?tab=readme-ov-file

https://www.cnblogs.com/xiao987334176/p/18821197

https://www.cnblogs.com/ryanzheng/p/18781666

https://www.cnblogs.com/xiao987334176/p/18822444

https://www.modb.pro/db/1878984329888542720

https://blog.moontak.com/id/522381/

https://github.com/liaokongVFX/MCP-Chinese-Getting-Started-Guide

https://zhuanlan.zhihu.com/p/28700850694

Python使用FastMCP开发MCP服务端

MCP简介 Model Context Protocol (MCP) 是一个专门为 LLM（大语言模型）应用设计的协议，它允许你构建服务器以安全、标准化的方式向 LLM 应用程序公开数据和功能。FastMCP 作为 Python 生态中的一款轻量级框架，利用装饰器来简化路由…...

编程日记 2025/8/26 15:15:40

ESLint常见错误

1、Strings must use singlequote —— 字符串必须使用单引号 2、Extra semicolon semi——额外的分号：一行语句结尾不能添加分号 3、Unexpected trailing comma —— 行尾多了一个逗号 4、Newline required at end of file but not found ——文件结尾必须要新加…...

编程日记 2025/8/26 13:14:46

京东硬核挑战潜规则，外卖算法要变天？

刘强东这次回归后的动作，真是越来越有看头了！最近那段内部讲话视频爆出来，直接扔了个重磅炸弹：京东外卖，净利润率永远不许超过5%，谁敢超标就得挨处分！这话一出，整个外卖圈估计都得抖…...

编程日记 2025/8/25 12:41:14

怎样利用 macOS 自带功能快速进行批量重命名文件教程

在日常办公或个人使用中，我们经常需要对多个文件进行重命名操作。幸运的是，macOS 提供了一套非常实用的内置工具，可以轻松完成这一任务而无需借助任何第三方应用程序。今天，我们就来详细介绍如何利用 macOS 自带的功能实现文件的批…...

编程日记 2025/8/26 14:36:03

Java Spring Cloud框架使用及常见问题

Spring Cloud作为基于Spring Boot的分布式微服务框架，显著简化了微服务架构的开发与管理。其核心优势包括集成Eureka、Ribbon、Hystrix等组件，提供一站式服务发现、负载均衡、熔断容错等解决方案，支持动态配置与消息总线，实现高效…...

编程日记 2025/8/25 17:06:06

机器视觉检测Pin针歪斜应用

在现代电子制造业中，Pin针（插针）是连接器、芯片插座、PCB板等元器件的关键部件。如果Pin针歪斜，可能导致接触不良、短路，甚至整机失效。传统的人工检测不仅效率低，还容易疲劳漏检。 MasterAlign 机器视觉对…...

编程日记 2025/8/26 11:11:15

抗量子算法验证工具

抗量子算法计算工具抗量子算法验证工具ML-KEMML-DSASLH-DSA 抗量子算法验证工具 2024年末，美国NIST陆续公布了FIPS-203、FIPS-204、FIPS-205算法标准文档，抽空学习了一下，做了个算法计算工具。 ML-KEM ML-DSA SLH-DSA 需要的朋友可留言交流…...

编程日记 2025/8/26 2:02:32

临床协调简历模板

模板信息简历范文名称：临床协调简历模板，所属行业：其他 | 职位，模板编号：C1S3WO 专业的个人简历模板，逻辑清晰，排版简洁美观，让你的个人简历显得更专业，找到好工作。希…...

编程日记 2025/8/26 14:05:11

linux命令八

tmux防止远程管理中断格式:tmux # 进入会话模式进入会话模式后,你进行文件的压缩时,如果远程管理突然中断,也不会影响压缩的进程 DNS服务器作用：负责域名解析的服务器，将域名解析为IP地址 /etc/resolv.conf:指定DNS服务器地址配置文件日志管理 •常见…...

编程日记 2025/8/25 6:07:43

37-串联所有单词的子串

给定一个字符串 s 和一个字符串数组 words。 words 中所有字符串长度相同。 s 中的串联子串是指一个包含 words 中所有字符串以任意顺序排列连接起来的子串。例如，如果 words ["ab","cd","ef"]， 那么 "abcdef…...

编程日记 2025/8/24 6:47:59

机器学习赋能的多尺度材料模拟与催化设计前沿技术

随着新能源、先进制造等领域对功能材料性能要求的日益严苛，传统材料研发模式面临显著挑战：跨尺度关联机制不清晰、实验试错周期长、计算资源消耗巨大。人工智能技术与多尺度模拟方法的深度融合，为材料科学开辟了“数据驱动物理建模”的创新路…...

编程日记 2025/8/25 12:59:58

HarmonyOS-ArkUI V2工具类：AppStorageV2:应用全局UI状态存储

AppStorageV2是一个能够跨界面存储数据，管理数据的类。开发者可以使用AppStorageV2来存储全局UI状态变量数据。它提供的是应用级的全局共享能力，开发者可以通过connect绑定同一个key，进行跨ability数据共享。概述 AppStorageV2是一个单例，创建时间是应用UI启动时。其目的…...

编程日记 2025/8/26 6:31:04

【Linux】进程池bug、命名管道、systemV共享内存

一.进程池bug 我们在之前进程池的创建中是通过循环创建管道，并且让子进程与父进程关闭不要的读写段以构成通信信道。但是我们这样构建的话会存在一个很深的bug。我们在销毁进程池时是先将所有的信道的写端关闭，让其子进程read返回值为0，并…...

编程日记 2025/8/26 12:20:42

.Net 9 webapi使用Docker部署到Linux

参考文章连接： https://www.cnblogs.com/kong-ming/p/16278109.html .Net 6.0 WebApi 使用Docker部署到Linux系统CentOS 7 - 长白山 - 博客园项目需要跨平台部署，所以就研究了一下菜鸟如何入门Net跨平台部署，演示使用的是Net 9 webAPi Li…...

编程日记 2025/8/26 16:46:24

【差分隐私相关概念】瑞丽差分隐私（RDP）引理1

引理1的详细推导过程引理1陈述若分布 P P P 和 Q Q Q 满足： D ∞ ( P ∥ Q ) ≤ ϵ 且 D ∞ ( Q ∥ P ) ≤ ϵ , D_\infty(P \parallel Q) \leq \epsilon \quad \text{且} \quad D_\infty(Q \parallel P) \leq \epsilon, D∞(P∥Q)≤ϵ且D∞(Q∥P)≤ϵ, …...

编程日记 2025/8/23 20:58:50

Java练习——day1（反射）

文章目录练习1练习2练习3思考封装原则与反射合理使用反射“破坏”封装的场景练习1 编写代码，通过反射获取String类的所有公共方法名称，并按字母顺序打印。示例代码： import java.lang.reflect.Method; import java.util.Arrays;public …...

编程日记 2025/8/26 9:04:15

【C++】二叉搜索树

目录一、二叉搜索树 🍔二叉搜索树概念 🍟二叉搜索树的操作 🌮二叉搜索树的实现 🥪二叉搜索树的应用 🥙二叉搜索树的效率分析二、结语一、二叉搜索树 🍔二叉搜索树概念二叉搜索树又称二叉排序树&…...

编程日记 2025/8/24 10:01:36

fastjson2 使用bug

fastjson2 版本2.0.52 转jsonString保留null值求助有如下对象： JSONObject jsonObject {“A”:null,“B”:“value”} 当服务运行几天之后， 还是这个json格式，因为需要保留null值，如下方法： jsonObject.toJSONString…...

编程日记 2025/8/24 18:06:21

Redis日常维护技巧与常见问题解决方案

Redis是一个开源的内存数据存储系统，广泛应用于缓存、消息队列、实时分析等场景。由于其高性能和持久化特性，越来越多的企业开始引入Redis。然而，要使Redis高效、稳定地运行，日常的维护和问题解决显得尤其重要。本文将分享一些Red…...

编程日记 2025/8/26 1:14:05

【Leetcode-Hot100】最小覆盖子串

题目解答想到使用双指针哈希表来实现，双指针的left和right控制实现可满足字符串。 class Solution(object):def minWindow(self, s, t):""":type s: str:type t: str:rtype: str"""len_s, len_t len(s), len(t)hash_map {}for…...

编程日记 2025/8/24 8:05:52

【Sequelize】关联模型和孤儿记录

一、关联模型的核心机制 1. 关联类型与组合规则 • 基础四类型： • hasOne：外键存储于目标模型（如用户档案表存储用户ID） • belongsTo：外键存储于源模型（如订单表存储用户ID） • hasMany&…...

编程日记 2025/8/26 9:47:53

系统分析师-第三遍-章节导图

导图要求： 第一章绪论第二章数学与工程基础导图要不偏瘫...

编程日记 2025/8/26 7:39:25

算法（ALGORITHMS）---- 关于阶乘

Everyday life is different,even with your state and mind!So if i have some new ways or logic to make a good Algorithms,I gonna post it and share with U guys! If there is anything error aboubt what I demonstrated,pls speak out on the comment,Thanks! 一.最初…...

编程日记 2025/8/24 2:01:36

MCP简介

MCP概述

标准输入输出(stdio)

基于Http的服务器推送事件(http sse)

环境介绍

uv快速构建Python环境

基本使用方法

版本推荐

实现步骤

stdio

sse模式

Vscode-Cline调用

stdio模式调用

sse模式

相关文章：