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