Python?FastMCP構(gòu)建MCP服務(wù)端與客戶端的詳細(xì)步驟
簡介
MCP(Multi-Client Protocol)是一種用于構(gòu)建可擴(kuò)展服務(wù)的通信協(xié)議框架。本文將以 FastMCP 庫為核心,通過一個(gè)簡單的「打招呼」服務(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工具注冊
使用 @mcp.tool 裝飾器將 greet 函數(shù)注冊為 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:啟動(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é)議的高級特性。實(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)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Python實(shí)現(xiàn)的簡單計(jì)算器功能詳解
這篇文章主要介紹了Python實(shí)現(xiàn)的簡單計(jì)算器功能,結(jié)合實(shí)例形式詳細(xì)分析了Python實(shí)現(xiàn)計(jì)算器功能的具體步驟、相關(guān)操作技巧與注意事項(xiàng),需要的朋友可以參考下2018-08-08
python內(nèi)置進(jìn)制轉(zhuǎn)換函數(shù)的操作
這篇文章主要介紹了python內(nèi)置進(jìn)制轉(zhuǎn)換函數(shù)的操作,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-06-06
淺析python中numpy包中的argsort函數(shù)的使用
這篇文章主要介紹了python中numpy包中的argsort函數(shù)的使用,argsort()函數(shù)在模塊numpy.core.fromnumeric中,本文通過實(shí)例代碼給大家介紹的非常詳細(xì),需要的朋友參考下吧2018-08-08
基于python的BP神經(jīng)網(wǎng)絡(luò)及異或?qū)崿F(xiàn)過程解析
這篇文章主要介紹了基于python的BP神經(jīng)網(wǎng)絡(luò)及異或?qū)崿F(xiàn)過程解析,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-09-09
python實(shí)現(xiàn)簡單flappy bird
這篇文章主要為大家詳細(xì)介紹了python實(shí)現(xiàn)簡單flappy bird小游戲,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-12-12

