Enhanced FAST MCP

增强型 FastAPI MCP 服务器

一个集成了FastMCP（模型上下文协议）的综合FastAPI应用程序，具备交互式前端仪表板和多种实用工具。

📹（视频或摄像机的符号，无实际文字含义，可理解为“视频”或“摄像机”） 屏幕录制演示

观看完整演示： 屏幕录制

视频显示：

• ✅ MCP服务器正在运行（python enhanced_server.py mcp)
• ✅ Gemini CLI MCP 列表命令 (mcp list）
• ✅ 通过CLI使用MCP工具
• ✅ 带有温度转换器的交互式前端
• ✅ 所有15+种MCP工具均在使用中

🎯（瞄准目标） 提交详情

项目使用FAST MCP的MCP服务器\ 截止日期2025年10月4日\ 仓库（或存储库）： \ 演示视频： https://drive.google.com/file/d/1O4CHunMQFL7IzcyBI0_TLjSNnX9Wc-3z/view?usp=sharing（该链接可翻译为：“谷歌云端硬盘文件链接：/d/1O4CHunMQFL7IzcyBI0_TLjSNnX9Wc-3z 查看？通过分享访问”）但通常我们不会直接翻译链接，而是说明其用途或内容，如：“这是一个谷歌云端硬盘的文件链接，用于查看特定文件（文件ID为1O4CHunMQFL7IzcyBI0_TLjSNnX9Wc-3z），可通过分享访问。”

特点/特性

• 增强型FastAPI网络应用程序 带有交互式前端仪表板
• MCP服务器集成 提供15+种可用工具
• 交互式温度转换器 带有模态弹出窗口
• 与Gemini CLI兼容 用于AI助手集成
• 实时数据管理 为用户和待办事项（或“待办事项列表”）
• 漂亮的用户界面 使用 Tailwind CSS 和 Alpine.js
• 多种实用工具 （密码生成器、二维码、天气等）

可用的MCP工具

基本工具

1. greet_user(name) - 以用户的名字打招呼
2. add_numbers(a, b) - 加两个数
3. multiply_numbers(a, b) - 两个数相乘
4. calculate_area(length, width) - 计算矩形的面积和周长

数据管理

1. create_user_mcp(name, email, age) - 通过MCP创建一个新用户
2. get_all_users() - 获取所有用户
3. create_todo_mcp(task) - 通过MCP创建一个新的待办事项
4. get_all_todos() - 获取所有待办事项

系统与统计

1. get_system_info() - 获取系统信息
2. get_app_stats() - 获取应用程序统计信息

高级工具

1. generate_password(length, include_symbols) - 生成安全密码
2. convert_temperature(value, from_unit, to_unit) - 温度转换
3. text_analyzer(text) - 分析文本（字数统计、情感分析等）
4. url_shortener(url) - 创建短链接
5. qr_code_generator(text) - 生成二维码
6. weather_info(city) - 获取天气信息
7. file_info(file_path) - 获取文件信息
8. color_palette_generator() - 生成色彩搭配方案

安装

1. 克隆仓库：

git clone 
cd fastapi-mcp-server

1. 安装依赖项：

pip install -r requirements.txt

用法

运行增强版FastAPI网络服务器

python enhanced_server.py

访问交互式仪表板，请前往：http://localhost:8001

运行MCP服务器

python enhanced_server.py mcp

测试MCP工具

python final_test.py

Gemini CLI 集成

1. 安装Gemini CLI：

npm install -g @google/generative-ai-cli

1. 在Gemini CLI中配置MCP服务器：

{
  "mcpServers": {
    "Enhanced FastAPI MCP Server": {
      "command": "python",
      "args": ["enhanced_server.py", "mcp"]
    }
  }
}

1. 使用Gemini CLI进行测试：

gemini mcp list
gemini mcp call greet_user --name "Alice"
gemini mcp call add_numbers --a 5 --b 3

API 端点

• GET / - 欢迎页面
• GET /health - 健康检查
• GET /users - 列出所有用户
• POST /users - 创建一个新用户
• GET /todos - 列出所有待办事项
• POST /todos - 创建一个新的待办事项
• POST /calculate - 进行计算
• GET /stats - 应用统计
• GET /docs - Swagger UI 文档

项目结构

├── enhanced_server.py          # Main Enhanced FastAPI + MCP server
├── fastapi_mcp_server.py       # Original FastAPI + MCP server
├── fastapi_app.py              # Standalone FastAPI app
├── server.py                   # Simple MCP server
├── final_test.py               # Comprehensive MCP testing script
├── test_mcp_tools.py           # MCP tools testing script
├── requirements.txt            # Python dependencies
├── README.md                   # This file
├── SUBMISSION.md               # Submission details
└── gemini_cli_config.json     # Gemini CLI configuration

测试

运行综合测试套件：

python final_test.py

或者运行单独的测试：

python test_mcp_tools.py
python quick_test.py

许可证

麻省理工学院许可证（MIT License）