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ù)中添加日志打印;
使用 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)文章希望大家以后多多支持腳本之家!
- Python快速開發(fā)一個MCP服務(wù)器的實現(xiàn)示例
- 使用Python+Bright Data MCP實時抓取Google搜索結(jié)果完整教程
- 基于Python從零構(gòu)建一個MCP服務(wù)器
- 使用Python構(gòu)建MCP服務(wù)器的詳細(xì)配置步驟
- Python使用FastMCP實現(xiàn)Word文檔與JSON數(shù)據(jù)互轉(zhuǎn)
- python開發(fā)Streamable?HTTP?MCP應(yīng)用小結(jié)
- Python?MCPInspector調(diào)試思路詳解
- 通過Python調(diào)用MCP的實現(xiàn)示例
相關(guān)文章
Python實現(xiàn)學(xué)校管理系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了Python實現(xiàn)學(xué)校管理系統(tǒng),具有一定的參考價值,感興趣的小伙伴們可以參考一下2018-01-01
PyQt5實現(xiàn)數(shù)據(jù)的增刪改查功能詳解
這篇文章主要為大家介紹了如何使用Python中的PyQt5模塊來實現(xiàn)數(shù)據(jù)的增、刪、改、查功能,文中示例代碼講解詳細(xì),感興趣的小伙伴可以了解一下2022-03-03
pycharm 在debug循環(huán)時快速debug到指定循環(huán)次數(shù)的操作方法
在 PyCharm 中,可以使用條件斷點來實現(xiàn)在特定循環(huán)次數(shù)后停止調(diào)試,本文重點介紹pycharm 在debug循環(huán)時快速debug到指定循環(huán)次數(shù)的操作方法,需要的朋友可以參考下2024-04-04
詳解將Pandas中的DataFrame類型轉(zhuǎn)換成Numpy中array類型的三種方法
這篇文章主要介紹了詳解將Pandas中的DataFrame類型轉(zhuǎn)換成Numpy中array類型的三種方法,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-07-07
Python代碼輕松實現(xiàn)Excel兩列數(shù)據(jù)對比
這篇文章主要為大家詳細(xì)介紹了如何使用Python的pandas庫實現(xiàn)Excel兩列數(shù)據(jù)的自動化對比,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2026-03-03
以視頻爬取實例講解Python爬蟲神器Beautiful Soup用法
這篇文章主要以視頻爬取實例來講解Python爬蟲神器Beautiful Soup的用法,Beautiful Soup是一個為Python獲取數(shù)據(jù)而設(shè)計的包,簡潔而強大,需要的朋友可以參考下2016-01-01

