ida-pro-mcp

让 AI 直接读 IDA 反编译结果,边聊边改函数名

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 1659 🐛 待处理 59 👀 关注 64
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 13517
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自备IDA Pro

项目预览

ida-pro-mcp 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队mrexodia
定价模式🏷️完全免费
价格说明开源免费,需自备IDA Pro
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai,aiagent,binary-analysis,ida-plugin,ida-pro,mcp,mcp-server,modelcontextprotocol,reverse-engineering
GitHub 星标★ 13517
上线时间2025-03-25 00:00:00
代码更新2026-11-12
仓库体积2.4 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

ida-pro-mcp 是一个把 IDA Pro 与语言模型连接起来的 MCP 服务器,用 Python 实现。它解决的核心问题是:逆向工程中大量重复性工作(函数重命名、反编译代码解读、结构体推断、交叉引用梳理)需要人工逐条处理,而通用 AI 助手无法直接读取 IDA 的数据库。项目通过 MCP 协议把 IDA Pro 的反编译结果、函数列表、字符串、交叉引用等能力暴露成工具接口,让支持 MCP 的客户端可以调用,从而在对话中完成代码分析、批量重命名、注释生成等操作。核心能力包括:读取反编译伪代码、列出与搜索函数、获取交叉引用、修改变量/函数名与注释、导出分析上下文给模型。它适合安全研究人员、恶意代码分析人员和漏洞挖掘者作为辅助工具,把机械性整理工作交给模型,人专注于判断与验证。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 13517

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 10 分钟 部署方式:本地安装 7 步

环境要求

  • Python 3.11 或更高版本(可用 idapyswitch 切换到最新 Python)
  • IDA Pro 8.3 或更高版本(推荐 9),不支持 IDA Free
  • 一个支持 MCP 的客户端,如 Claude Code、Codex、Cursor、Cline 等
  • 安装 Kimi Code 插件时需保证 uv 在 PATH 中

安装与启动步骤

  1. 1确认前置环境

    先装好 Python 3.11+ 与 IDA Pro 8.3+,并选定一个支持 MCP 的客户端;IDA Free 无法使用本项目。

  2. 2切换 IDA 的 Python

    用 IDA 自带的 idapyswitch 把 IDA 使用的 Python 切换到已安装的新版本,避免版本过低。

    idapyswitch
  3. 3安装命令行包

    先卸载旧版本,再从仓库主干压缩包安装 ida-pro-mcp,确保拿到最新代码。

    pip uninstall ida-pro-mcp
    pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip
  4. 4写入客户端配置

    执行 --install 自动配置 MCP 服务器并安装 IDA 插件,命令由包自身提供。

    ida-pro-mcp --install
  5. 5完全重启生效

    彻底关闭 IDA 和 MCP 客户端再重开;Claude 等客户端会驻留托盘,需从托盘退出。

  6. 6或用 Claude Code 插件

    若使用 Claude Code,可改为通过插件市场安装,三条命令依次执行。

    claude plugin marketplace add mrexodia/claude-marketplace
    claude plugin uninstall ida-pro-mcp@mrexodia
    claude plugin install ida-pro-mcp@mrexodia
  7. 7或用 Kimi Code 安装

    在 Kimi Code 对话中执行斜杠命令安装 idalib 服务与 idapython 技能,首次会话因解析依赖较慢。

    /plugins install https://github.com/mrexodia/ida-pro-mcp/tree/main
    /reload

关键配置

配置项必填说明示例
KIMI_CODE_HOME否Kimi Code 插件安装目录,插件会被复制到其下的 plugins/managed/。$KIMI_CODE_HOME/plugins/managed/

如何确认成功

重启后 MCP 客户端能列出 ida-pro-mcp 提供的工具,且 ida-pro-mcp --install 执行无报错。

常见问题

Q:可以用 IDA Free 吗?

A:不可以,README 明确说明不支持 IDA Free,需要 IDA Pro 8.3 及以上版本。

Q:Python 版本不够怎么办?

A:使用 IDA 自带的 idapyswitch 切换到本机已安装的最新 Python,再重新安装。

Q:安装完客户端里看不到工具?

A:需要完全重启 IDA 和客户端;像 Claude 这类常驻托盘的客户端要从托盘图标彻底退出。

Q:GUI 插件方式还能用吗?

A:仍可手动配置,但 README 说明该方式已不再推荐并将逐步弃用,建议改用 idalib-mcp。

Q:项目作者还推荐这个仓库吗?

A:作者在 README 顶部推荐改用官方 Hex-Rays IDA MCP Server,可优先考虑官方版本。

注意事项

  • 项目作者已在 README 顶部建议改用官方 Hex-Rays IDA MCP Server。
  • 必须拥有 IDA Pro 授权,IDA Free 不受支持。
  • GUI 手动配置的 MCP 插件方式将逐步弃用,仅作兼容选择。
  • 安装过程中不要同时打开旧版本客户端,否则配置可能不生效。

核心亮点

  • 通过 MCP 标准协议对接,客户端可替换,不绑定单一模型或编辑器
  • 直接读取 IDA 反编译伪代码与交叉引用,模型拿到的是真实分析上下文而非截图
  • 支持回写函数名、变量名和注释,分析结果能落回 IDB,减少手工重复操作

不足之处

  • 依赖 IDA Pro 商业授权,无正版 IDA 的用户无法使用
  • 工具调用结果受模型上下文长度限制,大型二进制需分批分析,效果依赖使用者拆解策略
  • 对复杂混淆或加壳样本,模型推断易出错,仍需人工复核

适用场景

  • 恶意样本分析时,让模型批量解读反编译函数并生成注释
  • 漏洞挖掘中快速梳理交叉引用与调用链,定位可疑参数来源
  • 逆向学习或代码审计时,用对话方式理解陌生二进制模块的逻辑

替代项目

GhidraMCP、binaryninja-mcp、mcp-server-ida

上一篇:xiaohongshu-mcp

下一篇:mcp-atlassian

同类项目推荐

superlocalmemory 开源

本地优先 AI 记忆,数据不出门,检索率破 74%

Open-source governed, local-first memory control plane for AI agents and teams. arXi···

★ 278 2026-08-09
blankspace 开源

在浏览器里直接让 AI 帮你写代码,改完即用

AI coding agent in your browser

★ 111 2026-08-09
AutoGPT-Next-Web 开源

浏览器里拖拽配置,一键部署你的私人 AutoGPT

Assemble, configure, and deploy autonomous AI Agents in your browser.一键免费部署你的···

★ 2994 2026-08-09
Resource2Skill 开源

把人类教程自动变成智能体可调用的技能

A general framework for distilling human-created multimodal resources into reusable,···

★ 562 2026-11-03
LaVague 开源

用大白话指挥浏览器干活,无需写代码

Large Action Model framework to develop AI Web Agents

★ 6398 2026-08-09
ai--manus 开源

在沙箱里让 AI 真正动手跑工具、做任务

AI Manus is a general-purpose AI Agent system that supports running various tools an···

★ 186 2026-11-14
agent-c 开源

用 C 语言打造超轻量 AI 智能体,资源受限也能跑

Ultra-lightweight AI Agent

★ 444 2026-08-09
Clouds-Coder 开源

把编码代理搬上浏览器,长任务断了也能接着跑。

Clouds Coder is a local-first coding agent platform centered on separating the CLI e···

★ 288 2026-08-09
wanwu 开源

企业级多租户AI智能体平台,可视化编排工作流与RAG应用

China Unicom's Yuanjing Wanwu Agent Platform is an enterprise-grade, multi-tenant AI···

★ 2386 2026-08-09