MCP Server Practice

🚀 🧠 MCP 服務器實踐

本項目是一個基於 FastAPI 的模塊化服務器，由 FastMCP 提供支持。它展示了 AI 工具、數學運算、網絡搜索、音頻響應生成以及外部 API 集成的實際應用，為相關開發提供了實用的參考。

🚀 快速開始

本服務器運行時，可使用如下命令：

mcp.run(transport="stdio")

✨ 主要特性

🔧 數學工具

• add(a, b): 返回兩個整數的和。
• multiply(a, b): 返回兩個整數的乘積。

🌤️ 天氣 API 集成

• get_weather(city): 使用 天氣 API 獲取指定城市的即時天氣數據。

🌐 網絡搜索（通過 OpenAI 工具）

• web_search(query): 使用 OpenAI 的網絡搜索工具執行即時搜索，並返回簡潔的結果。

🔊 音頻響應生成

• audio_query(text): 將文本查詢轉換為語音響應（WAV 格式），使用 OpenAI 的 gpt-4o 音頻功能。音頻文件會自動保存到 /audio 文件夾中。

🙋♂️ 自定義資源示例

• greeting://{name}: 使用基於資源的路由，返回個性化的問候字符串。

🔧 技術細節

🛠️ 使用的技術

• FastMCP: 工具-based 工作流的服務器接口。
• FastAPI: 高性能 API 的 Web 框架。
• OpenAI: 提供 AI 基於搜索、聊天和音頻生成的功能。
• 天氣 API: 外部 API 用於即時天氣更新。
• Python + dotenv: 用於腳本編寫和安全的環境變量處理。

💻 工作原理

每個工具都使用 @mcp.tool() 裝飾器定義，使其作為可調用接口對 AI 代理或 CLI 工具可用。