IDA Pro MCP文档与工具

提供用于通过MCP(机器代码处理器)与IDA Pro交互的文档和工具,适用于IDA Pro插件和脚本开发的学习与测试。

  • by Sysc4lls
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sysc4lls/ida-doc-hint-mcp

使用说明

IDA Pro MCP文档和实用程序

本项目提供了通过MCP(机器代码处理器)使用IDA Pro的文档和实用程序。

这个项目是为了让我自己学习如何使用MCP,而不是为了在现实生活中使用。

⚠️ 系统要求

  • 需要安装IDA Pro
  • Python 3.8或更高版本

🔧 先决条件

  1. IDA Pro安装
    • 确保IDA Pro安装正常
    • 设置 IDADIR 指向IDA Pro安装目录的环境变量
      # Example (PowerShell):
      $env:IDADIR = "C:\Program Files\IDA Pro"
      # or set it permanently through Windows System Properties > Environment Variables
      

📥 安装

  1. 安装诗歌 (如果尚未安装)

    (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
    

    或

    pipx install poetry
    
  2. 再进行

    poetry install
    

🚀 设置MCP服务器

  1. 光标MCP配置设置
    "ida-pro-doc": {
       "command": "<venv_python_path>/python.exe",
       "args": [
         "<path_to_project>/server.py"
       ]
     }
    

🔍 故障排除

  1. 如果遇到MCP服务器问题:

    • 确保 IDADIR 环境变量设置正确
    • 验证IDA Pro安装是否正常工作
    • 检查是否有任何防病毒软件阻止了连接
  2. 常见问题:

    • “未找到IDADIR”:按照先决条件中所示设置环境变量
    • 连接被拒绝:确保没有其他MCP服务器实例正在运行
    • 仅限Windows:此项目已经过测试,仅在Windows系统上受支持
    • 仅光标:此项目仅在游标内部进行了测试,但应可与其他软件配合使用。

📝 备注

  • 服务器使用idalib,不需要打开ida pro!(仅在IDA 9.0之后才支持)
  • 在启动MCP服务器之前,始终确保IDA Pro已正确关闭
  • MCP服务器需要运行才能使任何IDA Pro自动化脚本工作
  • 该项目目前仅支持Windows,不支持其他操作系统,但应该可以工作(稍作调整)
  • 这是一个粗略的愚蠢实现,但它适用于我的测试,它允许LLM更好地理解它可以访问的ida pro的api, 这将有助于为ida开发插件和脚本!

如有任何疑问,请随时通过以下方式联系我sysc4lls@gmai.com

📄 许可证

MIT许可证

版权所有(c)2024 IDA Pro MCP文档和实用程序