🚀 🧠 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 工具可用。