热mcp服务器
最小，易于运行 模型上下文协议（MCP） 服务器，展示与温度相关的工具，并演示外部进程（温度计、物联网设备、脚本等）如何写入启用MCP的客户端可以使用的数据。
该项目有意设计得较小、可读性强，并作为更高级MCP工具的基础。
______________________________________________________________________
⭐ 特性
✔ 最小FastMCP服务器
提供两个MCP工具：
get_latest_temperature()--读取最新的温度JSON文件set_latest_temperature()--将新的温度值写入JSON文件
______________________________________________________________________
✔ 外部作者脚本
thermometer_listener.py 通过将温度数据写入JSON文件来模拟硬件温度计。\ 这模拟了真实世界的设备或cron作业如何将数据馈送到MCP。
______________________________________________________________________
✔ 通知模块
notifier.py 将可读消息输出到stderr。\ 您可以扩展此功能以集成警报、日志、Webhook或推送通知系统。
______________________________________________________________________
✔ 光标IDE兼容
包含 可选的 .cursor/ 配置 因此，Cursor MCP客户端会自动检测并加载服务器。
______________________________________________________________________
📂 项目结构
thermo-mcp-server/
│
├── server.py # MCP server — exposes temperature tools
├── thermometer_listener.py # Simulated device that writes temperature JSON
├── notifier.py # Simple stderr logger + threshold notifier
├── mcp_config.json # Generic MCP config for MCP clients
├── requirements.txt # Python deps (FastMCP + base libs)
│
├── data/
│ └── latest_temp.json # Storage for temperature readings
│
└── .cursor/ (optional)
└── commands/
└── mcp.md # Cursor MCP command helper______________________________________________________________________
🚀 快速启动（终端）
运行这些 在repo文件夹内:
cd thermo-mcp-server______________________________________________________________________
1.创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate______________________________________________________________________
2.安装依赖项
pip install -r requirements.txt______________________________________________________________________
3.确保数据文件夹存在
mkdir -p data
echo "{}" > data/latest_temp.json______________________________________________________________________
▶ 运行MCP服务器
启动服务器：
python server.py- 在Cursor/ChatGPT/Claude Desktop中：MCP握手自动开始。
- 在终端中：它等待JSON-RPC（正常行为）。
______________________________________________________________________
🌡 写温度
模拟温度计读数：
python thermometer_listener.py --temp 72.5 --unit FJSON写入示例 data/latest_temp.json:
{
"temperature": 72.5,
"unit": "F",
"timestamp": "2025-12-06T04:36:52Z",
"source": "listener"
}添加阈值警报：
python thermometer_listener.py --temp 90 --unit F --threshold 85______________________________________________________________________
📁 温度文件格式
服务器读/写：
data/latest_temp.json例子：
{
"temperature": 70.0,
"unit": "F",
"timestamp": "2025-12-06T04:00:00Z",
"source": "listener"
}______________________________________________________________________
🧪 MCP工具暴露
get_latest_temperature() → dict
返回解析后的JSON温度数据。
set_latest_temperature(value: float, unit: str = "F") → dict
写入新的温度条目（值+时间戳）。
______________________________________________________________________
💻 光标集成（可选）
游标用户可以自动启用MCP服务器。
内部文件：
.cursor/允许Cursor发现并连接到MCP服务器，而无需手动设置。
______________________________________________________________________
🛠 开发说明
- 代码有意简单且可扩展
- 非常适合进行MCP实验
- 易于扩展：
- 设备硬件 - 推送通知 - 云集成 - 自动化
- 修改和分叉安全
______________________________________________________________________
🤝 贡献
PR欢迎！\ 思想：
- 其他MCP工具
- 物联网集成
- 通知管道
- 改进的示例
______________________________________________________________________
📄 许可证
MIT许可证\ 免费用于学习、实验和生产。