花生壳 内网穿透 MCP Server

花生壳 MCP 可将花生壳内网穿透（隧道）能力接入 Trae、Claude Desktop 等支持 MCP 的 AI 智能体，让你用自然语言完成隧道的查询、创建、启停与配置管理，从而更轻松地管理网络基础设施。

功能概览

• 账户信息：查询当前花生壳账户等级、流量使用情况、剩余隧道配额
• 隧道管理：列出/搜索/查看详情/创建/开启/暂停/修改配置/删除隧道
• AI 协作：将“创建映射、恢复访问、调整端口”等需求交给 AI 自动执行，并在花生壳管理平台复核结果

核心特点

• 自然语言驱动：用对话方式完成内网穿透隧道的日常运维与变更
• 统一工作流：在 AI 编程工具或桌面 AI 客户端内直接管理花生壳隧道
• 面向运维场景：适用于开发联调、临时公网暴露、服务恢复、配置变更等常见需求

使用场景

• 开发联调与演示：将本地 Web/接口服务快速映射到公网，便于外部访问与演示
• 远程访问内部服务：通过隧道将内网服务安全暴露，减少临时网络配置成本
• 故障恢复与运维：让 AI 排查隧道状态、启停隧道、调整配置并输出可复核结果
• 多隧道管理：在账号下批量搜索隧道、查看详情，提升排障与维护效率

快速开始（以 Trae 为例）

1. 生成 MCP 配置（含 Token）

在花生壳管理平台（https://console-v2.oray.com）：

• 点击【MCP】->【生成新Token】->【复制含Token的MCP配置JSON】
• 该 JSON 将用于后续在 AI 客户端中添加花生壳 MCP Server

2. 在 Trae 添加 MCP Server

在 Trae：

• 打开【设置】->【MCP】
• 在 MCP Server 界面点击【手动添加】
• 粘贴从花生壳管理平台复制的“含花生壳 Token 的 MCP 配置 JSON”

3. 开始使用

• 配置完成后，在 AI 聊天窗口将智能体切换为“Builder winth MCP”
• 若使用 SOLO 模式：可在智能体中添加 hsk MCP，无需切换智能体即可调用 hsk MCP
• 与智能体对话时：需设置保存该项目的文件路径，设置好后可正常对话
• 直接用自然语言描述需求并引导 AI 执行操作（例如“创建一个 HTTP 映射到本地 8080 端口”）
• 操作完成后，可在花生壳管理平台查看 AI 创建/修改的映射结果

工具能力（功能指南）

功能操作	用途说明
查询账户信息	查看当前花生壳账户的等级、流量使用情况以及剩余的隧道配额
列出所有隧道	显示当前账户下所有已创建的内网穿透隧道列表
搜索隧道	支持按名称、协议（如 HTTP/TCP）或本地端口快速查找特定隧道
查看隧道详情	获取某个特定隧道的详细运行状态和配置信息
创建新隧道	新建一个映射规则，将本地服务（如网站或数据库）暴露到公网
开启隧道	启动一个处于停止状态的隧道，使其恢复访问
暂停隧道	暂时停止一个隧道的服务，但不删除配置，随时可以再次开启
修改隧道配置	调整现有隧道的名称、本地 IP 地址或端口号等设置
删除隧道	永久移除一个不再使用的隧道映射

推荐的 AI 客户端

• Trae
• Claude Desktop
• 其他支持 MCP 协议的 AI 智能体/客户端

注意事项

• MCP 配置中包含 Token，请妥善保管，避免泄露
• 建议在执行“删除/修改配置”等不可逆操作前，让 AI 先输出变更摘要并人工确认

支持

• 使用指南（内部）：https://service.oray.com/question/50213.html
• 花生壳管理平台：https://console-v2.oray.com