IDASQL MCP Server

关键词

IDA Pro反汇编分析SQL 查询自动化分析大模型助手

使用说明 创作背景与定位

  • 该项目在 IDASQL 的代码库中实现了一个可运行的 MCP 服务器，依赖 fastmcpp 库提供 MCP 服务端能力，并通过 SSE（Server-Sent Events）与 MCP 客户端进行通信。
  • 服务器核心允许通过名为 idasql_query 的工具执行对 IDA 数据库的 SQL 查询，查询结果以文本形式返回，异常情况以错误信息返回。

主要功能点

  • MCP 服务端实现：实现了 MCP 协议的核心交互，承载和执行工具、资源等能力描述，提供与 LLM 客户端的接口。
  • 工具注册与执行：注册一个名为 idasql_query 的工具，输入为包含查询 SQL 的对象，输出为查询结果文本或错误信息。
  • 请求排队与并发控制：支持在队列中的排队执行与超时管理，保证在高并发场景下的稳定性。
  • SSE 传输端点：通过 SSE 做为传输层，与 MCP 客户端进行通信，支持 /sse 路径与消息通道。
  • 与 IDA 的深度整合：通过 IDA 的数据库查询能力执行 SQL，结果可用于继续分析、组合查询等工作流。

安装步骤

  • 将源码在支持 MCP 的环境下编译开启 MCP 支持（需要在编译时开启 -DIDASQL_WITH_MCP=ON）。
  • 构建完成后，使用命令启动 MCP 服务器（示例：idasql -s <database.i64> --mcp，若需要固定端口可传入端口如 --mcp 9500）。
  • 服务器启动后会输出接入地址，通常形如 http://<主机>:<端口>/sse。

服务器配置（MCP 客户端连接信息） 注：MCP 客户端需要一个包含服务器信息的配置，以下 JSON 示例描述服务器端信息及启动参数。实际使用时请替换占位符为具体的数据库路径和端口等。

{ "server_name": "idasql", "command": "idasql", "args": ["-s", "<path-to-database.i64>", "--mcp", "<port>"] // 如果端口为空，则使用随机端口；客户端在连接时通过返回的 URL 获取实际端口 }

说明

  • server_name：服务器在 MCP 客户端中的标识名称，便于区分及日志记录。
  • command：启动 MCP 服务器的执行命令。对于本实现，命令为 idasql。
  • args：启动命令的参数，包括数据库路径和 MCP 启动参数（如端口）。若不指定端口，服务器将分配一个可用的随机端口。

基本使用方法

  • 作为 MCP 服务端，先确保在编译时开启 MCP 支持，然后启动服务器。
  • MCP 客户端通过上述配置连接，使用 /sse 通道进行通信，并通过工具调用执行 SQL 查询。
  • 服务器内部采用队列管理和超时机制，确保在高并发场景中的稳健性。

注意

  • MCP 功能需在构建阶段开启，且客户端配置需指向服务器的 SSE 端点。
  • 本实现的 MCP 服务器以 idasql_query 工具为核心入口，演示了 MCP 与 IDA Pro 数据库的交互能力，实际应用可在此基础上扩展更多资源、工具、模板等能力。

关键词 IDA Pro, 反汇编分析, SQL 查询, 自动化分析, 大模型助手

分类 6

服务器信息

访问项目