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工具注冊(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:啟動(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)文章
對(duì)numpy 數(shù)組和矩陣的乘法的進(jìn)一步理解
下面小編就為大家分享一篇對(duì)numpy 數(shù)組和矩陣的乘法的進(jìn)一步理解,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2018-04-04
一篇文章帶你了解python標(biāo)準(zhǔn)庫--os模塊
在本篇內(nèi)容里小編給大家整理的是關(guān)于Python中os模塊及用法相關(guān)知識(shí)點(diǎn),有興趣的朋友們可以學(xué)習(xí)下,希望能給你帶來幫助2021-08-08
Python實(shí)現(xiàn)AI自動(dòng)摳圖實(shí)例解析
這篇文章主要介紹了Python實(shí)現(xiàn)AI自動(dòng)摳圖實(shí)例解析,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-03-03
使用Python構(gòu)造hive insert語句說明
這篇文章主要介紹了使用Python構(gòu)造hive insert語句說明,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-06-06
python非阻塞式后臺(tái)如何運(yùn)行bat腳本
這篇文章主要介紹了python非阻塞式后臺(tái)如何運(yùn)行bat腳本問題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-06-06
Python實(shí)戰(zhàn)項(xiàng)目之MySQL tkinter pyinstaller實(shí)現(xiàn)學(xué)生管理系統(tǒng)
讀萬卷書不如行萬里路,只學(xué)書上的理論是遠(yuǎn)遠(yuǎn)不夠的,只有在實(shí)戰(zhàn)中才能獲得能力的提升,本篇文章手把手帶你用MySQL、tkinter、 pyinstaller實(shí)現(xiàn)一個(gè)學(xué)生管理系統(tǒng),大家可以通過案例查缺補(bǔ)漏,提升水平2021-10-10

