IDA Pro MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 助手能够与 IDA Pro 交互，以进行逆向工程和二进制分析任务。

<a href="https://glama.ai/mcp/servers/@fdrechsler/mcp-server-idapro"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@fdrechsler/mcp-server-idapro/badge" alt="IDA Pro Server MCP server" /> </a>

概述

该项目提供了一个 AI 助手和 IDA Pro 之间的桥梁，IDA Pro 是一种流行的反汇编器和调试器，用于逆向工程软件。 它由三个主要组件组成：

1. IDA Pro 远程控制插件 (ida_remote_server.py): 一个 IDA Pro 插件，它创建一个 HTTP 服务器来远程控制 IDA Pro 功能。
2. IDA 远程客户端 (idaremoteclient.ts): 一个 TypeScript 客户端，用于与 IDA Pro 远程控制服务器交互。
3. MCP 服务器 (index.ts): 一个模型上下文协议服务器，它将 IDA Pro 功能暴露给 AI 助手。

特性

• 从 AI 助手在 IDA Pro 中执行 Python 脚本
• 检索有关二进制文件的信息：
  • 字符串
  • 导入
  • 导出
  • 函数
• 高级二进制分析功能：
  • 在指令中搜索立即数值
  • 在二进制文件中搜索文本字符串
  • 搜索特定的字节序列
  • 获取地址范围的反汇编代码
• 通过标准化接口自动化 IDA Pro 操作
• 组件之间的安全通信

前提条件

• IDA Pro 8.3 或更高版本
• Node.js 18 或更高版本
• TypeScript

示例用法 ida_remote_server.py

curl -X POST -H "Content-Type: application/json" -d '{"script":"print(\"Script initialization...\")"}' http://127.0.0.1:9045/api/execute
{"success": true, "output": "Script initialization...\n"}

示例用法 MCP 服务器

安装

1. 安装 IDA Pro 远程控制插件

1. 将 ida_remote_server.py 复制到您的 IDA Pro 插件目录：

   • Windows: %PROGRAMFILES%\IDA Pro\plugins
   • macOS: /Applications/IDA Pro.app/Contents/MacOS/plugins
   • Linux: /opt/idapro/plugins

2. 启动 IDA Pro 并打开一个二进制文件。

3. 该插件将自动在 127.0.0.1:9045 上启动一个 HTTP 服务器。

2. 安装 MCP 服务器

1. 克隆此存储库：

   git clone <repository-url>
   cd ida-server
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 在 AI 助手的 MCP 设置文件中配置 MCP 服务器：

   {
     "mcpServers": {
       "ida-pro": {
         "command": "node",
         "args": ["path/to/ida-server/dist/index.js"],
         "env": {}
       }
     }
   }
   

用法

安装和配置完成后，MCP 服务器为 AI 助手提供以下工具：

run_ida_command

执行 IDA Pro Python 脚本。

参数：

• scriptPath (必需): 要执行的脚本文件的绝对路径
• outputPath (可选): 保存脚本输出的绝对路径

示例：

# Example IDA Pro script (save as /path/to/script.py)
import idautils

# Count functions
function_count = len(list(idautils.Functions()))
print(f"Binary has {function_count} functions")

# Get the first 5 function names
functions = list(idautils.Functions())[:5]
for func_ea in functions:
    print(f"Function: {ida_name.get_ea_name(func_ea)} at {hex(func_ea)}")

# Return data
return_value = function_count

AI 助手可以使用以下命令使用此脚本：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>run_ida_command</tool_name>
<arguments>
{
  "scriptPath": "/path/to/script.py"
}
</arguments>
</use_mcp_tool>

search_immediate_value

在二进制文件的指令中搜索立即数值。

参数：

• value (必需): 要搜索的值（数字或字符串）
• radix (可选): 数字转换的基数（默认值：16）
• startAddress (可选): 搜索的起始地址
• endAddress (可选): 搜索的结束地址

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>search_immediate_value</tool_name>
<arguments>
{
  "value": "42",
  "radix": 10
}
</arguments>
</use_mcp_tool>

search_text

在二进制文件中搜索文本字符串。

参数：

• text (必需): 要搜索的文本
• caseSensitive (可选): 搜索是否区分大小写（默认值：false）
• startAddress (可选): 搜索的起始地址
• endAddress (可选): 搜索的结束地址

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>search_text</tool_name>
<arguments>
{
  "text": "password",
  "caseSensitive": false
}
</arguments>
</use_mcp_tool>

search_byte_sequence

在二进制文件中搜索特定的字节序列。

参数：

• bytes (必需): 要搜索的字节序列（例如，“90 90 90”表示三个 NOP）
• startAddress (可选): 搜索的起始地址
• endAddress (可选): 搜索的结束地址

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>search_byte_sequence</tool_name>
<arguments>
{
  "bytes": "90 90 90"
}
</arguments>
</use_mcp_tool>

get_disassembly

获取地址范围的反汇编代码。

参数：

• startAddress (必需): 反汇编的起始地址
• endAddress (可选): 反汇编的结束地址
• count (可选): 要反汇编的指令数

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>get_disassembly</tool_name>
<arguments>
{
  "startAddress": "0x401000",
  "count": 10
}
</arguments>
</use_mcp_tool>

get_functions

从二进制文件中获取函数列表。

参数：

• 无需参数

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>get_functions</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

get_exports

从二进制文件中获取导出列表。

参数：

• 无需参数

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>get_exports</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

get_strings

从二进制文件中获取字符串列表。

参数：

• 无需参数

示例：

<use_mcp_tool>
<server_name>ida-pro</server_name>
<tool_name>get_strings</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

IDA Pro 远程控制 API

IDA Pro 远程控制插件公开以下 HTTP 端点：

• GET /api/info: 获取插件信息
• GET /api/strings: 从二进制文件中获取字符串
• GET /api/exports: 从二进制文件中获取导出
• GET /api/imports: 从二进制文件中获取导入
• GET /api/functions: 获取函数列表
• GET /api/search/immediate: 在指令中搜索立即数值
• GET /api/search/text: 在二进制文件中搜索文本
• GET /api/search/bytes: 在二进制文件中搜索字节序列
• GET /api/disassembly: 获取地址范围的反汇编代码
• POST /api/execute: 执行 Python 脚本 (JSON/Form)
• POST /api/executebypath: 从文件路径执行 Python 脚本
• POST /api/executebody: 从原始正文执行 Python 脚本

安全注意事项

默认情况下，IDA Pro 远程控制插件仅侦听 127.0.0.1 (localhost)，以确保安全。 这可以防止远程访问您的 IDA Pro 实例。

如果需要允许远程访问，可以修改 ida_remote_server.py 中的 DEFAULT_HOST 变量，但请注意安全隐患。

开发

从源代码构建

npm run build

运行测试

npm test

许可证

该项目根据 MIT 许可证获得许可。 有关详细信息，请参见 LICENSE 文件。

作者

Florian Drechsler (@fdrechsler) fd@fdrechsler.com