Fastmcp Fastapi

FastAPI+MCP服务器示例

此存储库演示了在Python中创建MCP（模型上下文协议）服务器的两种不同方法：

1. FastAPI MCP (fastapimcp.py)-既可作为FastAPI web应用程序又可作为MCP服务器的混合服务器
2. FastMCP (fastmcp.py)-使用FastMCP v2的独立MCP服务器

🚀 快速开始

先决条件

• Python 3.13+
• pip或uv包管理器

安装g

1. 克隆此存储库：

git clone 
cd fmcp

1. 安装依赖项：

pip install -e .

或使用紫外线：

uv sync

📋 可用工具

这两种实现都提供了相同的核心功能：

• 总数 -将两个整数相加
• 问候用户 -生成个性化问候
• 翻译文本 -使用谷歌翻译在语言之间翻译文本
• 天气警报 -获取美国各州的活跃天气警报

🔧 用法

选项1:FastAPI MCP（混合服务器）

这 fastapimcp.py 文件创建了一个服务器 两者 web API和MCP服务器。

作为Web API运行：

python fastapimcp.py

• 访问web界面：http://127.0.0.1:8000
• API文件：http://127.0.0.1:8000/docs
• MCP端点：http://127.0.0.1:8000/mcp

测试API终点：

# Sum two numbers
curl -X POST "http://127.0.0.1:8000/sum" \
  -H "Content-Type: application/json" \
  -d '{"a": 5, "b": 3}'

# Greet user
curl -X POST "http://127.0.0.1:8000/greet" \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice"}'

# Translate text
curl -X POST "http://127.0.0.1:8000/translate" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "target_lang": "es"}'

# Get weather alerts
curl -X POST "http://127.0.0.1:8000/alerts" \
  -H "Content-Type: application/json" \
  -d '{"state": "CA"}'

用作MCP服务器：

将MCP客户端连接到： http://127.0.0.1:8000/mcp

选项2:FastMCP（独立MCP服务器）

这 fastmcp.py 该文件使用FastMCP v2创建了一个专用的MCP服务器。

运行MCP服务器：

python fastmcp.py

服务器将于启动 http://127.0.0.1:8000 并提供MCP协议端点。

🔌 MCP客户端集成

Claude桌面配置

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "fastapi-mcp": {
      "command": "python",
      "args": ["path/to/fastapimcp.py"],
      "env": {}
    },
    "fastmcp": {
      "command": "python", 
      "args": ["path/to/fastmcp.py"],
      "env": {}
    }
  }
}

其他MCP客户端

这两个服务器都公开了与任何MCP兼容客户端一起工作的标准MCP协议端点。

📁 项目结构

fmcp/
├── fastapimcp.py      # FastAPI + MCP hybrid server
├── fastmcp.py         # Standalone FastMCP v2 server  
├── weather_helper.py  # Weather API utilities
├── pyproject.toml     # Project dependencies
└── README.md          # This file

🛠️ 主要区别

🔍 学习资源

了解FastAPI MCP

• 将FastAPI的web框架与MCP功能相结合
• 自动将FastAPI路由转换为MCP工具
• 当您需要web API和MCP功能时很有用

了解FastMCP v2

• 专为MCP协议构建
• 更简单的基于装饰器的方法
• 支持工具和资源
• 非常适合专用MCP服务器

🐛 故障排除

常见问题

1. 端口已在使用中：更改相应文件中的端口
2. 缺少依赖项：运行 pip install -e . 安装所有要求
3. 天气API错误：NWS API需要正确的User-Agent标头（已配置）
4. 翻译错误：确保Google Translate API的互联网连接

调试模式

向任一服务器添加调试日志记录：

import logging
logging.basicConfig(level=logging.DEBUG)

📝 许可证

本项目按原样提供，用于教育和示范目的。

🤝 贡献

请随时提交问题和增强请求！