MCP Disaster Center

🚨 MCP灾害预警中心

智能AI驱动的模型上下文协议（MCP）服务器和客户端，通过基于LLM的工具编排演示实时灾难警报管理。

🎯 概述

该项目展示了 灾害警报指挥中心 构建于：

• MCP服务器 （.NET 10）-通过WebSocket上的JSON-RPC 2.0提供灾难警报工具
• AI代理客户端 （.NET 10）-具有流式响应的自然语言接口
• 谷歌Gemma 4法学硕士 -智能工具选择和推理
• 实时警报 -模拟灾难事件流式传输到订阅的客户端

✨ 特性

🤖 AI代理架构

• 自然语言理解 -接受自由形式的用户输入
• Agent推理 -LLM用人类的语言解释其理解
• 智能路由 -根据意图选择合适的工具
• 回退匹配 -LLM不可用时的关键字匹配
• 流输出 -ChatGPT/Claude风格的逐个字符流

🛠️ 可用工具

1. subscribe_disaster -订阅警报类型（地震、洪水、风暴）
2. get_alerts -检索所有活动的灾难事件
3. incident_summary -基于人工智能的当前事件分析

🚀 快速开始

先决条件

• .NET 10 SDK
• Google Gemma 4 API密钥（获取 谷歌人工智能工作室)

安装

# Clone the repository
git clone https://github.com/ndoteddy/mcp-disaster-center.git
cd mcp-disaster-center

# Set up API key (PowerShell)
$env:GEMMA_API_KEY = "your-api-key-here"

运行演示

终端1-启动MCP服务器：

cd server
dotnet run -c Debug

终端2-启动AI代理客户端：

cd client
dotnet run -c Debug

示例用法

🧠 You: show me active incidents
🤖 Agent: Thinking...
💭 Agent Reasoning: The user wants to see a list of current disaster 
    incidents to stay informed about ongoing emergencies.
🔧 Selected tool: get_alerts
✔️ [10/10] FLOOD in Hilltown @ 08:08:41
   [8/10] EARTHQUAKE in Coastville @ 08:08:43
   [6/10] STORM in Hilltown @ 08:07:27

命令

/help              - Show all commands
/tools             - List available tools
/subscribe   - Subscribe to alerts (earthquake, flood, storm)
/get-alerts        - Get current active alerts
/incident-summary  - AI analysis of active incidents
/quit              - Exit

🏗️ 建筑

MCP协议

• 符合JSON-RPC 2.0的消息传递
• 用于实时通信的WebSocket传输
• 通过以下方式发现工具 tools/list 方法
• 通过以下方式调用工具 tools/call 方法
• 订阅客户端的实时通知

AI代理流

1. 用户输入 -自然语言命令
2. Agent推理 -LLM解释理解
3. 工具选择 -LLM选择合适的工具
4. 执行 -通过MCP协议调用工具
5. 结果 -逐字符流响应

组件

服务器（MCP协议提供程序）

• WebSocket侦听器打开 localhost:5000
• 灾害管理工具定义
• 实时警报生成（2-5秒间隔）
• LLM集成用于事件分析
• 会话/订阅管理

客户端（AI代理）

• 启动时的工具发现
• 双阶段LLM推理
• 巧妙地回退到关键字匹配
• 逐字符流式输出
• 错误弹性和恢复

🔌 API集成

谷歌Gemma 4

• 端点： https://generativelanguage.googleapis.com/v1beta/models/gemma-4-31b-it:generateContent
• 认证： 查询参数 key={GEMMA_API_KEY}
• 每个请求两次LLM调用：

1. 用户意图原因 1. 选择并执行适当的工具

🎓 学习成果

该项目展示了：

• MCP协议实施和最佳实践
• WebSocket实时通信
• LLM与回退模式的集成
• 流式/分块响应
• AI代理推理模式
• 异步/等待C#模式
• 实时指挥中心用户体验

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🙏 致谢

• Anthropic -MCP规范
• 谷歌人工智能 -杰玛4 LLM API
• .NET基础 -ASP。NET核心

______________________________________________________________________

MCP协议和AI代理编排的课堂演示 🎓