IDA MCP 服务器

[!NOTE] idalib 模式正在开发中，它将不再需要安装 IDA 插件或运行 IDA（idalib 自 IDA Pro 9.0+ 起可用）。

概述

用于 IDA 交互和自动化的模型上下文协议服务器。该服务器提供通过大型语言模型读取 IDA 数据库的工具。

请注意，mcp-server-ida 目前仍处于早期开发阶段。随着我们持续开发和改进服务器，其功能和可用工具可能会发生变化并不断扩展。

安装

使用 uv（推荐）

使用 uv 时，无需进行特定安装。我们将使用 uvx 直接运行 mcp-server-ida。

使用 PIP

或者，您也可以通过 pip 安装 mcp-server-ida：

pip install mcp-server-ida

安装完成后，您可以将其作为脚本运行：

python -m mcp_server_ida

IDA 端

将 repository/plugin/ida_mcp_server_plugin.py 和 repository/plugin/ida_mcp_server_plugin 目录复制到 IDA 的插件目录中：

Windows: %APPDATA%\Hex-Rays\IDA Pro\plugins

Linux/macOS: $HOME/.idapro/plugins，例如：~/.idapro/plugins

igors-tip-of-the-week-103-sharing-plugins-between-ida-installs

配置

与 Claude Desktop 配合使用

将以下内容添加到您的 claude_desktop_config.json 中：

"mcpServers": {
  "ida": {
    "command": "uvx",
    "args": [
        "mcp-server-ida"
    ]
  }
}

"mcpServers": {
  "ida": {
    "command": "python",
    "args": [
        "-m", 
        "mcp_server_ida"
    ]
  }
}

调试

您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-ida

或者，如果您已将软件包安装在特定目录中，或正在进行开发：

cd path/to/mcp-server-ida/src
npx @modelcontextprotocol/inspector uv run mcp-server-ida

运行 tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 将显示来自服务器的日志，并可能帮助您调试任何问题。

开发

如果您正在进行本地开发，有两种方法可以测试您的更改：

1. 运行 MCP 检查器来测试您的更改。有关运行说明，请参阅 调试。

2. 使用 Claude 桌面应用程序进行测试。将以下内容添加到您的 claude_desktop_config.json 中：

UVX

{
"mcpServers": {
  "ida": {
    "command": "uv",
    "args": [ 
      "--directory",
      "/<mcp-server-ida 的路径>",
      "run",
      "mcp-server-ida"
    ]
  }
}

替代方案

ida-pro-mcp

ida-mcp-server-plugin

mcp-server-idapro

pcm

截图

ida-mcp-server 快速上手指南

ida-mcp-server 是一个基于模型上下文协议（MCP）的服务器，旨在让大语言模型（LLM）能够读取和交互 IDA Pro 数据库，实现逆向工程的自动化辅助。

环境准备

在开始之前，请确保满足以下要求：

• 操作系统：Windows、Linux 或 macOS。
• IDA Pro：已安装 IDA Pro（推荐最新版本以支持未来的 idalib 模式）。
• Python 环境：
  • 方案 A（推荐）：安装 uv 工具管理器。
  • 方案 B：安装 Python 3.8+ 及 pip。
• 客户端：已安装支持 MCP 的客户端（如 Claude Desktop）。

注意：目前该工具处于早期开发阶段，功能可能会随版本更新而变化。未来将支持无需安装插件的 idalib 模式（需 IDA Pro 9.0+）。

安装步骤

1. 安装 Python 服务端

你可以选择使用 uv（推荐）或 pip 进行安装。

方式一：使用 uv（推荐，无需显式安装） 直接使用 uvx 运行，无需预先安装包：

uvx mcp-server-ida

方式二：使用 pip 安装

pip install mcp-server-ida
# 安装后可通过以下命令运行
python -m mcp_server_ida

(国内用户若遇网络问题，可添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 使用清华镜像源)

2. 部署 IDA 插件

为了让服务器能与 IDA 通信，需要将插件文件复制到 IDA 的插件目录中。

从项目仓库中复制以下两个内容：

• repository/plugin/ida_mcp_server_plugin.py
• repository/plugin/ida_mcp_server_plugin (整个文件夹)

目标路径：

• Windows: %APPDATA%\Hex-Rays\IDA Pro\plugins
• Linux / macOS: ~/.idapro/plugins

复制完成后，重启 IDA Pro 以确保插件加载。

基本使用

配置完成后，需在 MCP 客户端（以 Claude Desktop 为例）中注册该服务。

配置 Claude Desktop

编辑你的 claude_desktop_config.json 文件，根据你选择的安装方式添加以下配置：

场景 A：如果你使用 uvx (推荐)

"mcpServers": {
  "ida": {
    "command": "uvx",
    "args": [
        "mcp-server-ida"
    ]
  }
}

场景 B：如果你使用 pip 安装

"mcpServers": {
  "ida": {
    "command": "python",
    "args": [
        "-m", 
        "mcp_server_ida"
    ]
  }
}

验证与调试

配置保存并重启 Claude Desktop 后，你可以在对话中尝试询问关于当前打开的 IDA 数据库的问题（例如：“分析当前函数的逻辑”）。

如需排查连接问题，可以使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uvx mcp-server-ida

或者查看客户端日志（macOS 示例）：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log