Rainy MCP Server

一个真正支持 AI IDE（暂不支持Antigravity）的 Rainy MCP 服务器，实现了符合 MCP (Model Context Protocol) 规范的 SSE 传输层。（由 RainyMarks 开发）

特性

• 真正的 SSE 实现：完整实现 MCP SSE 传输规范，支持 EventSource 长连接
• 会话管理：自动管理客户端会话生命周期，支持超时清理
• 异步工具调用：工具执行不阻塞主线程，结果通过 SSE 推送
• 23 个强大工具：覆盖网络抓包、TLS/SSL分析、IPSec/ISAKMP、数字证书解析等场景
• 期末考试专用：支持 SM2/SM3/SM4 国密分析，TLS握手分析，证书公钥提取等
• 零外部 MCP 依赖：完全自包含实现，无需安装 mcp 包

架构

┌─────────────────┐     GET /sse      ┌──────────────────┐
│   Cursor IDE    │ ◄───────────────► │  SSE MCP Server  │
│  (MCP Client)   │                   │                  │
│                 │  POST /messages   │  - SessionMgr    │
│                 │ ────────────────► │  - ToolRegistry  │
│                 │                   │  - RainyMCP      │
└─────────────────┘                   └──────────────────┘
                                              │
                                              ▼
                                      ┌──────────────┐
                                      │   tshark     │
                                      │ (Wireshark)  │
                                      └──────────────┘

前置要求

• Python 3.8+
• Wireshark (需要 tshark 命令行工具)

安装 Wireshark

Windows:

• 下载安装 Wireshark
• 确保安装时勾选 "TShark" 组件
• 将 Wireshark 安装目录添加到系统 PATH（如 C:\Program Files\Wireshark）

macOS:

brew install wireshark

Linux (Ubuntu/Debian):

sudo apt install tshark

安装

# 克隆项目
git clone <repository-url>
cd Rainy_mcp

# 安装依赖
pip install -r requirements.txt

使用方法

1. 启动服务器

python rainy_mcp.py

可选参数：

python rainy_mcp.py --host 127.0.0.1 --port 3000 --tshark-path /path/to/tshark

启动成功后会显示：

服务器地址: http://127.0.0.1:3000
SSE 端点: http://127.0.0.1:3000/sse
消息端点: http://127.0.0.1:3000/messages
已注册 8 个 Rainy 工具

2. 配置 Cursor IDE

在项目根目录创建 mcp.json（或 .cursor/mcp.json）：

{
  "mcpServers": {
    "rainy": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

3. 在 Cursor 中使用

重启 Cursor 或刷新 MCP 连接后，可以直接使用 Rainy 工具：

"帮我分析这个 pcap 文件中的 HTTP 流量"

>

"列出所有可用的网络接口"

>

"提取流量包中的所有 IP 地址"

可用工具 (23个)

基础工具 (8个)

🎓 期末考试专用工具 (15个)

#### TLS/SSL 分析

#### IPSec/ISAKMP 分析

#### 数字证书解析

#### 流重组与协议分析

#### 安全检测与智能摘要

输出控制：证书/签名相关工具（如 analyze_tls_handshake、extract_certificates、parse_certificate、extract_public_key、get_signature_value）新增参数 full_output（默认 false），开启后不再截断长字段；流重组工具 follow_tcp_stream / follow_udp_stream 新增 max_lines（默认 2000，<=0 表示不截断）。

工具详细说明

list_interfaces

列出系统上所有可用的网络接口。

// 无需参数
{}

capture_live

实时抓包分析。需要管理员/root 权限。

{
  "interface": "eth0",        // 必需：网络接口名称
  "duration": 10,             // 可选：抓包时长（秒），默认 10
  "filter": "tcp port 80",    // 可选：BPF 过滤器
  "max_packets": 100          // 可选：最大数据包数，默认 100
}

analyze_pcap

分析已保存的 pcap 文件。

{
  "file_path": "capture.pcap",  // 必需：文件路径
  "filter": "http",             // 可选：显示过滤器
  "max_packets": 100            // 可选：最大数据包数
}

extract_fields

提取特定字段并统计。

{
  "file_path": "capture.pcap",
  "fields": ["ip.src", "ip.dst"],  // 必需：字段列表
  "filter": "",                     // 可选：显示过滤器
  "max_packets": 5000               // 可选：最大数据包数
}

analyze_errors

分析网络传输错误。

{
  "file_path": "capture.pcap",
  "error_type": "all",  // 可选：all/malformed/tcp/retransmission/duplicate_ack/lost_segment
  "max_packets": 5000
}

🎓 期末考试场景示例

第八章：TLS 分析

> "分析这个pcap中的TLS握手，找出random随机数和cipher_suites"
> "提取第一个包的随机数和第二个包选中的加密套件"

第八章：ISAKMP 分析

> "分析ISAKMP流量，找出主模式的前四个包"
> "提取IKE密钥交换中的DH公钥和证书"

第九章：数字证书分析

> "解析流量中的证书，提取公钥和签名值"
> "根据证书序列号找到对应的公钥"

第七章：SM2 签名验签

> "提取SM2签名值(r,s)和公钥，准备验签"
> "找出签名报文和签名原文"

第六章：SM3 摘要

> "从证书中提取国密SM3摘要值"

端点说明

SSE 协议流程

1. Client ──GET /sse──────────────────────────► Server
2. Client ◄──event: endpoint, data: /messages?session_id=xxx── Server
3. Client ──POST /messages?session_id=xxx────► Server
   (JSON-RPC: initialize)
4. Client ◄──event: message, data: {result}─── Server
5. Client ──POST /messages (tools/list)──────► Server
6. Client ◄──event: message, data: {tools}─── Server
7. Client ──POST /messages (tools/call)──────► Server
8. Client ◄──event: message, data: {content}─ Server

常见问题

Q: 为什么看不到网络接口？

A: 列出网络接口需要管理员权限。请以管理员身份运行 PowerShell/终端后启动服务器。

Q: Cursor 连接失败怎么办？

1. 确认服务器已启动且在 3000 端口运行
2. 检查 mcp.json 配置是否正确（使用 url 而非 serverUrl）
3. 访问 http://127.0.0.1:3000/status 确认服务器状态
4. 重启 Cursor 刷新 MCP 连接

Q: tshark 命令找不到？

确保 Wireshark 已安装且 tshark 在系统 PATH 中。可以通过 --tshark-path 参数指定完整路径：

python rainy_mcp.py --tshark-path "C:\Program Files\Wireshark\tshark.exe"

技术栈

• Web 框架: Starlette (ASGI)
• 服务器: Uvicorn
• 协议: MCP over SSE (Server-Sent Events)
• 后端工具: tshark (Wireshark CLI)

许可证

MIT License