FastMCP Study Project

一个用于学习和演示 FastMCP 框架功能的研究项目，展示了如何构建不同类型的 MCP 服务器。

项目概述

本项目旨在通过实际示例来学习和理解 FastMCP 框架的核心概念。它包含了多种类型的 MCP 服务器实现，展示了不同的传输协议和功能特性。

主要功能

测试客户端

项目包含一个功能完整的测试客户端，能够：

• 连接不同类型的 MCP 服务器
• 执行全面的功能测试
• 验证服务器响应和错误处理
• 提供详细的测试报告

STDIO 服务器

基于标准输入输出协议的 MCP 服务器，提供：

• 数学运算和计算功能
• 文本分析和处理
• 数据集合操作
• 多语言问候服务
• 系统信息查询
• 动态资源管理

HTTP 服务器

基于 HTTP 协议的 MCP 服务器，具备：

• 网络请求检查功能
• 天气数据模拟
• 消息回显和格式化
• Web API 调试工具
• 实时数据生成
• HTTP 专用资源

共享组件库

为了减少代码重复和提高维护性，项目实现了：

• 可重用的工具组件
• 标准化的提示模板
• 统一的中间件支持
• 通用的错误处理机制

使用方法

环境准备

确保系统已安装 Python 3.12 或更高版本，并使用 uv 进行包管理。

安装依赖

uv sync

运行测试

快速功能测试：

# 测试 STDIO 服务器
uv run python main.py stdio

# 测试 HTTP 服务器
uv run python main.py http

特定功能测试：

# 测试服务器信息功能
uv run python main.py stdio --quick get_server_info

# 测试数学计算功能
uv run python main.py stdio --quick calculate --params '{"expression": "2+3*4"}'

项目特色

学习导向

• 清晰的代码结构和注释
• 渐进式的功能实现
• 详细的错误处理和日志记录
• 完整的测试覆盖

实用功能

• 多种传输协议支持
• 丰富的工具和资源
• 上下文感知的日志记录
• 进度跟踪和状态报告

可扩展性

• 模块化的组件设计
• 共享库的代码复用
• 标准化的接口定义
• 易于添加新功能

项目结构

项目采用工作空间架构，包含：

• 主测试客户端
• STDIO 传输服务器
• HTTP 传输服务器
• 共享组件库

每个组件都有明确的职责和功能边界，便于理解和维护。

学习价值

通过这个项目，您可以学习到：

• FastMCP 框架的基本概念
• MCP 协议的实际应用
• 不同传输协议的特点
• 代码复用的最佳实践
• 测试驱动的开发方法

这个项目为 FastMCP 的学习和实验提供了完整的示例，帮助开发者快速上手并理解框架的核心特性。