🛡️ MobSF MCP 工具

这是一个兼容 Model Context Protocol (MCP) 的工具，允许 MobSF（移动安全框架）直接通过 Claude、5ire 或任何支持 MCP 的客户端扫描 APK 和 IPA 文件。

🔧 先决条件

• 必须在系统上安装 MobSF。
• 下载 MCP TypeScript SDK，并将文件夹重命名为 sdk。

🚀 功能特性

• 支持 APK 和 IPA 文件扫描
• 使用 MobSF 的 REST API 进行：
  • 上传文件
  • 触发扫描
  • 获取分析摘要
  • 自动过滤大型结果（如字符串或密钥），以防止输出过载
• 通过 server.ts 提供 MCP 兼容接口

📁 安装

克隆仓库并安装依赖项：

git clone https://github.com/yourusername/mobsf-mcp.git
cd mobsf-mcp
npm install

🔌 设置

复制 .env.example 到 .env：

cp .env.example .env

编辑 .env 文件以包含您的 MobSF API 密钥和 URL：

MOBSF_API_KEY=YOUR_MOBSF_API_KEY
MOBSF_URL=http://localhost:8000

▶️ 运行服务器

• 添加 Claude AI 桌面应用配置文件中的设置，服务器会自动启动。
• 确保您的 MobSF 服务在本地运行于 http://localhost:8000。

🎞️ 示例输入

• 服务器暴露了工具 scanFile。因此，使用任何 MCP 客户端尝试以下命令：
  • scan <FILE>.apk
  • scan <FILE>.ipa

它将扫描 IPA 或 APK 文件，并为您分析报告（JSON 格式）。

📌 注意事项

• 仅支持 .apk 和 .ipa 文件类型。
• 该工具避免获取大型字段（如原始字符串或源码转储），以保持响应快速并符合 Claude/5ire 消息限制。

✅ Claude 配置文件示例

{
  "mcpServers": {
    "mobsf": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/server.ts"]
    }
  }
}

此工具通过与 MobSF 的集成，为移动应用安全分析提供了便捷的接口，特别适用于需要自动化和集成化安全测试的场景。