Python?FastMCP構(gòu)建MCP服務(wù)端與客戶端的詳細(xì)步驟
簡介
MCP(Multi-Client Protocol)是一種用于構(gòu)建可擴展服務(wù)的通信協(xié)議框架。本文將以 FastMCP 庫為核心,通過一個簡單的「打招呼」服務(wù)示例,手把手教你如何搭建一個支持 Streamable HTTP 傳輸協(xié)議的 MCP 服務(wù)端與客戶端。代碼已通過 Python 3.10+ 驗證。
環(huán)境準(zhǔn)備
安裝依賴庫:
pip install fastmcp
確保本地環(huán)境支持異步編程(Python 3.7+)。
服務(wù)端實現(xiàn)(server.py)
核心代碼解析
from fastmcp import FastMCP # 初始化 MCP 服務(wù)實例 mcp = FastMCP(name="MyServer") # 定義一個工具函數(shù) @mcp.tool def greet(name: str) -> str: """Greet a user by name.""" return f"Hello, {name}!" if __name__ == "__main__": # 啟動服務(wù)(Streamable HTTP 模式) mcp.run(transport="streamable-http", host="127.0.0.1", port=9000)
代碼詳解
1.服務(wù)初始化
FastMCP(name="MyServer") 創(chuàng)建了一個名為 MyServer 的 MCP 服務(wù)實例。
.2工具注冊
使用 @mcp.tool 裝飾器將 greet 函數(shù)注冊為 MCP 工具,客戶端可通過該工具名調(diào)用服務(wù)。
3.服務(wù)啟動
mcp.run() 方法以 Streamable HTTP 協(xié)議啟動服務(wù),監(jiān)聽本機 9000 端口。
客戶端實現(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: 自動管理連接生命周期,確保資源釋放。
3.工具調(diào)用
client.call_tool("greet", {"name": "world"}) 調(diào)用服務(wù)端的 greet 工具,傳遞參數(shù) {name: "world"}。
運行效果
步驟 1:啟動服務(wù)端
python server.py
輸出(服務(wù)端日志):
INFO: MyServer started on http://127.0.0.1:9000/mcp
步驟 2:運行客戶端
python client.py
輸出結(jié)果:
greet: Hello, world!
擴展方向
1.多服務(wù)集成
在客戶端配置中可添加多個 MCP 服務(wù)地址,實現(xiàn)分布式調(diào)用。
2.協(xié)議切換
嘗試替換 transport="stdio" 或 transport="websocket" 驗證其他傳輸協(xié)議。
3.工具參數(shù)驗證
為 greet 函數(shù)添加類型檢查或默認(rèn)值邏輯增強健壯性。
常見問題
Q1: 為什么客戶端提示 Connection refused?
確保服務(wù)端已啟動;
檢查防火墻是否開放 9000 端口;
確認(rèn) URL 地址格式是否正確(需包含 /mcp 路徑)。
Q2: 如何調(diào)試工具調(diào)用?
在服務(wù)端工具函數(shù)中添加日志打?。?/p>
使用 curl http://127.0.0.1:9000/mcp 驗證 HTTP 接口可達(dá)性。
結(jié)語
通過本文,你已掌握了使用 FastMCP 構(gòu)建基礎(chǔ) MCP 服務(wù)的核心方法。下一步可嘗試集成 JSON Schema 參數(shù)校驗、實現(xiàn)流式響應(yīng),或探索 MCP 協(xié)議的高級特性。實踐是學(xué)習(xí)的最佳途徑——試著用這個框架構(gòu)建你的第一個微服務(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內(nèi)置進制轉(zhuǎn)換函數(shù)的操作
這篇文章主要介紹了python內(nèi)置進制轉(zhuǎn)換函數(shù)的操作,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-06-06淺析python中numpy包中的argsort函數(shù)的使用
這篇文章主要介紹了python中numpy包中的argsort函數(shù)的使用,argsort()函數(shù)在模塊numpy.core.fromnumeric中,本文通過實例代碼給大家介紹的非常詳細(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í)價值,需要的朋友可以參考下2019-09-09