Python?FastMCP構(gòu)建MCP服務(wù)端與客戶端的詳細(xì)步驟
簡(jiǎn)介
MCP(Multi-Client Protocol)是一種用于構(gòu)建可擴(kuò)展服務(wù)的通信協(xié)議框架。本文將以 FastMCP 庫為核心,通過一個(gè)簡(jiǎn)單的「打招呼」服務(wù)示例,手把手教你如何搭建一個(gè)支持 Streamable HTTP 傳輸協(xié)議的 MCP 服務(wù)端與客戶端。代碼已通過 Python 3.10+ 驗(yàn)證。
環(huán)境準(zhǔn)備
安裝依賴庫:
pip install fastmcp
確保本地環(huán)境支持異步編程(Python 3.7+)。
服務(wù)端實(shí)現(xiàn)(server.py)
核心代碼解析
from fastmcp import FastMCP
# 初始化 MCP 服務(wù)實(shí)例
mcp = FastMCP(name="MyServer")
# 定義一個(gè)工具函數(shù)
@mcp.tool
def greet(name: str) -> str:
"""Greet a user by name."""
return f"Hello, {name}!"
if __name__ == "__main__":
# 啟動(dòng)服務(wù)(Streamable HTTP 模式)
mcp.run(transport="streamable-http", host="127.0.0.1", port=9000)
代碼詳解
1.服務(wù)初始化
FastMCP(name="MyServer") 創(chuàng)建了一個(gè)名為 MyServer 的 MCP 服務(wù)實(shí)例。
.2工具注冊(cè)
使用 @mcp.tool 裝飾器將 greet 函數(shù)注冊(cè)為 MCP 工具,客戶端可通過該工具名調(diào)用服務(wù)。
3.服務(wù)啟動(dòng)
mcp.run() 方法以 Streamable HTTP 協(xié)議啟動(dòng)服務(wù),監(jiān)聽本機(jī) 9000 端口。
客戶端實(shí)現(xiàn)(client.py)
核心代碼解析
import asyncio
from fastmcp import Client
# 配置 MCP 服務(wù)器地址
config = {
"mcpServers": {
"printer": {
"url": "http://127.0.0.1:9000/mcp",
"transport": "streamable-http"
}
}
}
# 初始化客戶端
client = Client(config)
async def main():
async with client:
# 調(diào)用服務(wù)端工具
greet_data = await client.call_tool("greet", {"name": "world"})
print(f"greet: {greet_data}")
if __name__ == "__main__":
asyncio.run(main())
代碼詳解
1.客戶端配置
config 字典定義了 MCP 服務(wù)的連接信息,包含 URL 和傳輸協(xié)議。
2.異步連接管理
使用 async with client: 自動(dòng)管理連接生命周期,確保資源釋放。
3.工具調(diào)用
client.call_tool("greet", {"name": "world"}) 調(diào)用服務(wù)端的 greet 工具,傳遞參數(shù) {name: "world"}。
運(yùn)行效果
步驟 1:?jiǎn)?dòng)服務(wù)端
python server.py
輸出(服務(wù)端日志):
INFO: MyServer started on http://127.0.0.1:9000/mcp
步驟 2:運(yùn)行客戶端
python client.py
輸出結(jié)果:
greet: Hello, world!
擴(kuò)展方向
1.多服務(wù)集成
在客戶端配置中可添加多個(gè) MCP 服務(wù)地址,實(shí)現(xiàn)分布式調(diào)用。
2.協(xié)議切換
嘗試替換 transport="stdio" 或 transport="websocket" 驗(yàn)證其他傳輸協(xié)議。
3.工具參數(shù)驗(yàn)證
為 greet 函數(shù)添加類型檢查或默認(rèn)值邏輯增強(qiáng)健壯性。
常見問題
Q1: 為什么客戶端提示 Connection refused?
確保服務(wù)端已啟動(dòng);
檢查防火墻是否開放 9000 端口;
確認(rèn) URL 地址格式是否正確(需包含 /mcp 路徑)。
Q2: 如何調(diào)試工具調(diào)用?
在服務(wù)端工具函數(shù)中添加日志打??;
使用 curl http://127.0.0.1:9000/mcp 驗(yàn)證 HTTP 接口可達(dá)性。
結(jié)語
通過本文,你已掌握了使用 FastMCP 構(gòu)建基礎(chǔ) MCP 服務(wù)的核心方法。下一步可嘗試集成 JSON Schema 參數(shù)校驗(yàn)、實(shí)現(xiàn)流式響應(yīng),或探索 MCP 協(xié)議的高級(jí)特性。實(shí)踐是學(xué)習(xí)的最佳途徑——試著用這個(gè)框架構(gòu)建你的第一個(gè)微服務(wù)吧!
server.py
# my_server.py
from fastmcp import FastMCP
mcp = FastMCP(name="MyServer")
@mcp.tool
def greet(name: str) -> str:
"""Greet a user by name."""
return f"Hello, {name}!"
if __name__ == "__main__":
# This runs the server, defaulting to STDIO transport
mcp.run(transport="streamable-http", host="127.0.0.1", port=9000)
# To use a different transport, e.g., HTTP:
# mcp.run(transport="streamable-http", host="127.0.0.1", port=9000)
client.py
import asyncio
from fastmcp import Client
# Create a standard MCP configuration with multiple servers
config = {
"mcpServers": {
# A local MCP server
"printer": {
"url": "http://127.0.0.1:9000/mcp",
"transport": "streamable-http"
}
}
}
# Create a client that connects to both servers
client = Client(config)
async def main():
async with client:
# Access tools from different servers with prefixes
greet_data = await client.call_tool("greet", {"name": "word"})
print(f"greet: {greet_data}")
if __name__ == "__main__":
asyncio.run(main())到此這篇關(guān)于Python FastMCP構(gòu)建MCP服務(wù)端與客戶端的詳細(xì)步驟的文章就介紹到這了,更多相關(guān)Python FastMCP構(gòu)建MCP服務(wù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- Python快速開發(fā)一個(gè)MCP服務(wù)器的實(shí)現(xiàn)示例
- 使用Python+Bright Data MCP實(shí)時(shí)抓取Google搜索結(jié)果完整教程
- 基于Python從零構(gòu)建一個(gè)MCP服務(wù)器
- 使用Python構(gòu)建MCP服務(wù)器的詳細(xì)配置步驟
- Python使用FastMCP實(shí)現(xiàn)Word文檔與JSON數(shù)據(jù)互轉(zhuǎn)
- python開發(fā)Streamable?HTTP?MCP應(yīng)用小結(jié)
- Python?MCPInspector調(diào)試思路詳解
- 通過Python調(diào)用MCP的實(shí)現(xiàn)示例
相關(guān)文章
Python如何生成一個(gè)高強(qiáng)度的10位密碼
這篇文章主要為大家詳細(xì)介紹了使用Python如何生成一個(gè)高強(qiáng)度的10位密碼,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2025-08-08
Python實(shí)現(xiàn)學(xué)校管理系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了Python實(shí)現(xiàn)學(xué)校管理系統(tǒng),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-01-01
PyQt5實(shí)現(xiàn)數(shù)據(jù)的增刪改查功能詳解
這篇文章主要為大家介紹了如何使用Python中的PyQt5模塊來實(shí)現(xiàn)數(shù)據(jù)的增、刪、改、查功能,文中示例代碼講解詳細(xì),感興趣的小伙伴可以了解一下2022-03-03
python批量識(shí)別圖片指定區(qū)域文字內(nèi)容
這篇文章主要為大家詳細(xì)介紹了python識(shí)別圖片指定區(qū)域文字內(nèi)容,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2019-04-04
pycharm 在debug循環(huán)時(shí)快速debug到指定循環(huán)次數(shù)的操作方法
在 PyCharm 中,可以使用條件斷點(diǎn)來實(shí)現(xiàn)在特定循環(huán)次數(shù)后停止調(diào)試,本文重點(diǎn)介紹pycharm 在debug循環(huán)時(shí)快速debug到指定循環(huán)次數(shù)的操作方法,需要的朋友可以參考下2024-04-04
詳解將Pandas中的DataFrame類型轉(zhuǎn)換成Numpy中array類型的三種方法
這篇文章主要介紹了詳解將Pandas中的DataFrame類型轉(zhuǎn)換成Numpy中array類型的三種方法,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-07-07
Python代碼輕松實(shí)現(xiàn)Excel兩列數(shù)據(jù)對(duì)比
這篇文章主要為大家詳細(xì)介紹了如何使用Python的pandas庫實(shí)現(xiàn)Excel兩列數(shù)據(jù)的自動(dòng)化對(duì)比,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2026-03-03
利用Python實(shí)現(xiàn)簡(jiǎn)單的驗(yàn)證碼處理
這篇文章主要介紹了利用Python實(shí)現(xiàn)簡(jiǎn)單的驗(yàn)證碼處理,文章圍繞主題展開詳細(xì)的內(nèi)容介紹,具有一定的參考價(jià)值,需要的小伙伴可以參考一下2022-06-06
在Pycharm中自動(dòng)添加時(shí)間日期作者等信息的方法
今天小編就為大家分享一篇在Pycharm中自動(dòng)添加時(shí)間日期作者等信息的方法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2019-01-01
以視頻爬取實(shí)例講解Python爬蟲神器Beautiful Soup用法
這篇文章主要以視頻爬取實(shí)例來講解Python爬蟲神器Beautiful Soup的用法,Beautiful Soup是一個(gè)為Python獲取數(shù)據(jù)而設(shè)計(jì)的包,簡(jiǎn)潔而強(qiáng)大,需要的朋友可以參考下2016-01-01

