MCP 演示项目 - 双实现版本

这个项目包含了 两个不同的 Model Context Protocol (MCP) 实现，用于学习和比较不同的实现方法。

🚀 快速开始

选择版本启动

# 使用启动选择器
.\start_demo.ps1

# 或直接选择版本:
# FastAPI版本 (概念演示)
cd mcp_fastapi_demo && .\setup_and_run.ps1

# MCP SDK版本 (官方实现)
cd mcp_sdk_demo && .\start_mcp_sdk.ps1

运行测试

# 使用测试选择器
.\run_tests_demo.ps1

# 或直接选择测试:
# FastAPI版本测试
cd mcp_fastapi_demo && .\test_with_venv.ps1

# MCP SDK版本测试
cd mcp_sdk_demo && .\test_mcp_sdk.ps1

📂 项目结构

mcpdemo/
├── mcp_fastapi_demo/        # 🔧 v1.0 - FastAPI概念演示版本
│   ├── main.py              # FastAPI应用主文件  
│   ├── mcp_server.py        # MCP功能模拟实现
│   ├── tools.py             # 工具定义
│   ├── config.py            # 配置文件
│   ├── client_test.py       # HTTP客户端测试
│   ├── requirements.txt     # FastAPI依赖包
│   └── README.md            # FastAPI版本文档
│
├── mcp_sdk_demo/            # 🚀 v2.0 - 官方SDK真实实现版本
│   ├── mcp_server_sdk.py    # MCP SDK服务器
│   ├── test_mcp_sdk.py      # MCP SDK客户端测试
│   ├── claude_desktop_config_example.json  # Claude Desktop配置
│   ├── requirements.txt     # MCP SDK依赖包
│   └── README.md            # MCP SDK版本文档
│
├── start_demo.ps1           # 🚀 快速启动选择器
├── run_tests_demo.ps1       # 🧪 测试选择器
├── venv/                    # 共享虚拟环境
└── README.md               # 本文件

🎯 两个版本对比

特性	FastAPI版本 (v1.0)	MCP SDK版本 (v2.0)
目的	学习MCP概念	真正的MCP协议实现
协议	RESTful HTTP API	MCP协议 + JSON-RPC
传输	HTTP/HTTPS	STDIO
客户端	Web浏览器、HTTP客户端	Claude Desktop、MCP兼容客户端
优势	简单易懂、有Web界面	真正的MCP协议、Claude Desktop兼容
限制	无法与真正MCP客户端连接	学习曲线稍陡、无Web界面

🛠️ 功能特性

两个版本都提供相同的工具功能：

• calculator - 数学计算工具 (+, -, *, /, sin, cos, sqrt等)
• text_analyzer - 文本分析工具 (字符统计、词频分析、阅读时间)
• file_reader - 文件读取工具 (安全文件访问、多格式支持)

🔌 Claude Desktop 集成

只有 MCP SDK版本 支持与Claude Desktop集成。详细配置请参考 mcp_sdk_demo/README.md。

📚 学习建议

初学者路径

1. 从FastAPI版本开始 - 理解MCP的基本概念
2. 查看Web界面 - 访问 http://localhost:8000/docs
3. 升级到SDK版本 - 体验真正的MCP协议

开发者路径

1. 直接使用SDK版本 - 用于生产环境
2. 配置Claude Desktop - 体验真实的AI助手集成

🔧 系统要求

• Python 3.10+
• PowerShell (Windows)
• 虚拟环境支持

---

选择建议：

• 🎓 学习MCP概念 → 使用 mcp_fastapi_demo
• 🚀 生产环境/Claude Desktop集成 → 使用 mcp_sdk_demo