Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Demo Servercalculate the square root of 256"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.ps1Related MCP server: Claude Desktop Commander MCP
📂 项目结构
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。
📚 学习建议
初学者路径
从FastAPI版本开始 - 理解MCP的基本概念
查看Web界面 - 访问 http://localhost:8000/docs
升级到SDK版本 - 体验真正的MCP协议
开发者路径
直接使用SDK版本 - 用于生产环境
配置Claude Desktop - 体验真实的AI助手集成
🔧 系统要求
Python 3.10+
PowerShell (Windows)
虚拟环境支持
选择建议：
🎓 学习MCP概念 → 使用
mcp_fastapi_demo🚀 生产环境/Claude Desktop集成 → 使用
mcp_sdk_demo
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.