热点MCP
用于Claude LLM和HotSpot大气扩散模拟代码集成的模型上下文协议（MCP）服务器
概要
HotSpot是美国DOE NARAC/LLNL开发的大气扩散模拟软件。该项目提供了一个MCP服务器，当Claude LLM用自然语言要求模拟时，它会自动运行HotSpot并返回结果。
主要功能
- run_hotspot_模拟：运行大气扩散模拟
- 获取可用放射性核素：查看可用放射性核素列表
- parse_hotspot_output：解析模拟结果
- 获取热点状态：检查服务器状态
支持的型号
| 型号 | 说明 |
|---|
tritium_release释放氚 plutonium_explosion钚爆炸 plutonium_fire钚火灾 铀爆炸 | general_plume |普通套间| |nuclear_explosion核爆
安装
# 가상환경 생성
python -m venv .venv
source .venv/bin/activate # macOS/Linux
# .venv\Scripts\activate # Windows
# 의존성 설치
pip install -r requirements.txt项目结构
hotspotMCP/
├── src/
│ ├── server.py # MCP 서버 메인
│ ├── hot_generator.py # .hot 파일 생성
│ ├── hotspot_runner.py # HotSpot 실행 (Mock 모드 포함)
│ ├── output_parser.py # 결과 파싱
│ ├── exceptions.py # 커스텀 예외
│ ├── logger.py # 로깅 설정
│ └── models/
│ └── schemas.py # Pydantic 데이터 모델
├── tests/
│ └── test_integration.py # 통합 테스트
├── docs/
│ ├── PRD_v2.md # 제품 요구사항 문서
│ ├── TASKS.md # 작업 계획서
│ └── HOTSPOT_ANALYSIS.md # HotSpot 기술 분석
├── requirements.txt
└── README.md使用方法
Mock模式测试（MacOS）
# 통합 테스트 실행
python tests/test_integration.py运行MCP服务器
# 서버 실행
python -m src.serverClaude Desktop集成（即将推出）
claude_desktop_config.json添加到：
{
"mcpServers": {
"hotspot": {
"command": "python",
"args": ["-m", "src.server"],
"cwd": "/path/to/hotspotMCP"
}
}
}状态
状态进度 |-------|------|--------| |第1阶段：环境构建和HotSpot分析|完成|100%| |第2阶段：MCP服务器基本结构实现|完成|100%| |Phase3:核心功能开发|完成100%| |第4阶段：测试和验证|完成100%|
Mock模式
HotSpot是Windows专用程序。提供Mock模式，以便在MacOS/Linux上进行开发和测试。
- Mock模式：返回示例结果（不运行实际HotSpot）
- 物理模式：在Windows上安装HotSpot后运行
参考资料
许可证
该项目旨在研究和培训。