快速手搓一個MCP服務指南（八）：FastMCP 代理服務器：構建靈活的 MCP 服務中介層

在分布式系統和微服務架構日益普及的今天，服務間的通信與集成變得至關重要。FastMCP 從 2.0.0 版本引入的代理服務器功能，為 MCP (Model Context Protocol) 生態提供了強大的服務中介能力。本文將深入解析 FastMCP 代理服務器的核心概念、應用場景與實踐方法，幫助開發者構建更靈活、更具擴展性的 MCP 服務架構。

代理服務器核心概念與價值

什么是 MCP 代理服務器

FastMCP 代理服務器是一種特殊的 MCP 服務器實例，它不直接實現工具或資源，而是作為中介將接收到的請求轉發給后端 MCP 服務器，并將響應回傳給原始客戶端。這種設計實現了服務的透明轉發，使客戶端無需關心后端服務的具體位置或傳輸協議。

代理服務器的核心工作流程如下：

接收客戶端的 MCP 請求（如工具調用、資源讀取）
將請求轉發給配置的后端 MCP 服務器
接收后端服務器的響應
將響應中繼回原始客戶端

核心應用場景

1. 傳輸協議橋接

將運行在一種傳輸協議上的服務器通過另一種協議暴露，實現不同傳輸層的互聯互通：

將遠程 SSE 服務器通過本地 Stdio 傳輸暴露給桌面應用
將 HTTP 傳輸的服務器轉換為 SSE 流模式

2. 功能增強層

在現有服務器前插入中間層，添加額外功能：

緩存常用請求結果，提升響應速度
統一日志記錄與監控
實現認證授權與請求過濾
修改請求/響應數據格式

3. 安全邊界控制

作為受控網關保護內部服務器：

限制外部對內部服務的直接訪問
實現請求頻率限制與流量監控
過濾敏感操作或參數

4. 服務抽象與簡化

提供統一穩定的端點，屏蔽后端服務的變化：

后端服務器位置變更時不影響客戶端配置
聚合多個后端服務為統一接口
簡化客戶端對多服務的調用復雜度

代理服務器的創建與基本用法

基于 `as_proxy` 方法的快速創建

FastMCP 提供了簡潔的 FastMCP.as_proxy() 類方法用于創建代理服務器，支持多種后端配置方式：

from fastmcp import FastMCP# 方式1：通過后端服務器地址創建代理
proxy1 = FastMCP.as_proxy("backend_server.py",  # 后端服務器文件路徑name="FileBackendProxy"
)# 方式2：通過遠程URL創建代理（如HTTP/SSE服務器）
proxy2 = FastMCP.as_proxy("http://example.com/mcp/sse",  # 遠程SSE服務器URLname="RemoteSSEProxy"
)# 方式3：通過已有的FastMCP實例創建內存代理
original_server = FastMCP(name="OriginalServer")@original_server.tool
def sample_tool() -> str:return "Sample Response"proxy3 = FastMCP.as_proxy(original_server,  # 內存中的FastMCP實例name="InMemoryProxy"
)

as_proxy 方法的內部實現邏輯：

使用提供的客戶端連接到后端服務器
發現后端服務器的所有工具、資源、模板和提示
創建對應的"代理"組件，負責請求轉發
返回標準的 FastMCP 服務器實例

傳輸協議橋接示例

以下示例展示了如何將遠程 SSE 服務器通過本地 Stdio 傳輸暴露，實現傳輸協議的橋接：

from fastmcp import FastMCP# 創建代理，將遠程SSE服務器橋接到本地Stdio
proxy = FastMCP.as_proxy("http://remote-server.com/mcp/sse",  # 遠程SSE服務器URLname="SSEToStdioProxy"
)# 運行代理服務器，使用Stdio傳輸
if __name__ == "__main__":proxy.run()

客戶端可以像連接普通本地服務器一樣連接此代理，無需關心后端實際上是通過 SSE 協議通信的遠程服務器。

基于配置字典的代理創建

從 2.4.0 版本開始，FastMCP 支持通過配置字典創建代理，簡化多服務器配置：

from fastmcp import FastMCP# 單服務器配置
single_config = {"mcpServers": {"default": {"url": "https://api.example.com/mcp","transport": "http"}}
}proxy_single = FastMCP.as_proxy(single_config,name="SingleConfigProxy"
)# 多服務器配置
multi_config = {"mcpServers": {"weather": {"url": "https://weather-api.com/mcp","transport": "http"},"calendar": {"url": "https://calendar-api.com/mcp","transport": "http"}}
}proxy_multi = FastMCP.as_proxy(multi_config,name="MultiServiceProxy"
)

多服務器代理會自動將后端服務按配置名稱添加前綴：

天氣服務工具：weather_get_forecast
日歷服務工具：calendar_add_event
資源訪問：weather://weather/icons/sunny

高級代理功能與定制

代理服務器的組件發現機制

代理服務器在啟動時會主動發現后端服務器的所有組件，并在本地建立映射：

工具發現：獲取所有工具的簽名、描述和參數
資源發現：讀取資源URI和訪問方式
模板發現：獲取參數化資源模板
提示發現：獲取預定義的LLM提示詞

這些信息會被緩存，客戶端可以通過標準的發現接口（如list_tools）獲取代理服務器的組件列表，就像訪問本地服務器一樣。

子類化 `FastMCPProxy` 實現自定義邏輯

對于需要更精細控制的場景，可以直接子類化 FastMCPProxy 類，重寫請求轉發前后的處理邏輯：

from fastmcp import FastMCP
from fastmcp.server.proxy import FastMCPProxyclass CustomProxy(FastMCPProxy):async def before_forward(self, request):"""請求轉發前的預處理"""# 添加全局請求頭request.headers["X-Proxy-Header"] = "FastMCP"# 記錄請求日志print(f"[Proxy] Forwarding request: {request.method}")return requestasync def after_forward(self, response):"""響應接收后的后處理"""# 過濾響應中的敏感數據if "sensitive_data" in response.data:response.data["sensitive_data"] = "[REDACTED]"# 記錄響應時間print(f"[Proxy] Received response in {response.elapsed_time}ms")return response# 使用自定義代理
backend_client = ...  # 后端客戶端配置
custom_proxy = CustomProxy(backend=backend_client,name="CustomProcessingProxy"
)

代理服務器的限制與注意事項

當前版本的代理服務器主要支持核心 MCP 組件（工具、資源、模板、提示）的轉發，以下功能尚未完全支持：

完整的通知機制（Fire-and-Forget 請求）
LLM 采樣功能的完整代理
復雜的流處理場景

這些功能將在未來版本中逐步完善，使用時需注意當前限制。

實戰案例：構建安全網關與服務聚合代理

案例1：構建帶認證的安全代理網關

以下示例展示了如何創建一個帶認證功能的代理網關，保護后端服務：

import httpx
from fastmcp import FastMCP
from fastmcp.client import Client# 配置認證信息的HTTP客戶端
authenticated_client = Client("https://internal-server.com/mcp",transport="http",headers={"Authorization": "Bearer SECURE_TOKEN","X-Proxy-ID": "gateway-001"}
)# 創建帶認證的代理服務器
security_proxy = FastMCP.as_proxy(authenticated_client,name="SecureGatewayProxy"
)# 添加請求過濾中間件
from fastmcp.server.middleware import Middleware, MiddlewareContextclass RequestFilterMiddleware(Middleware):async def on_call_tool(self, context: MiddlewareContext, call_next):# 禁止調用危險工具if context.message.name == "dangerous_tool":raise ValueError("Access to dangerous_tool is prohibited")return await call_next(context)security_proxy.add_middleware(RequestFilterMiddleware())# 運行安全代理網關
if __name__ == "__main__":security_proxy.run()

案例2：聚合多服務的統一代理

以下示例展示了如何創建一個聚合多個后端服務的統一代理：

from fastmcp import FastMCP# 多服務配置字典
multi_service_config = {"mcpServers": {"user_service": {"url": "https://user-api.com/mcp","transport": "http"},"order_service": {"url": "https://order-api.com/mcp","transport": "http"},"product_service": {"url": "https://product-api.com/mcp","transport": "http"}}
}# 創建聚合代理
aggregator_proxy = FastMCP.as_proxy(multi_service_config,name="ServiceAggregator"
)# 運行聚合代理，提供統一接口
if __name__ == "__main__":aggregator_proxy.run()