IDA Pro MCP 文档和实用工具

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

本项目纯粹是为了我自己学习如何使用 MCP 而创建的，不适用于实际生产环境。

⚠️ 系统要求

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

🔧 前提条件

1. IDA Pro 安装
   • 确保您已正确安装 IDA Pro
   • 设置 IDADIR 环境变量，指向您的 IDA Pro 安装目录

     # 示例 (PowerShell):
     $env:IDADIR = "C:\Program Files\IDA Pro"
     # 或者通过 Windows 系统属性 > 环境变量 永久设置
     

📥 安装

1. 安装 Poetry (如果尚未安装)

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

   或者

   pipx install poetry
   

2. 安装依赖

   poetry install
   

🚀 设置 MCP 服务器

1. Cursor MCP 配置设置

   "ida-pro-doc": {
      "command": "<venv_python_path>/python.exe",
      "args": [
        "<path_to_project>/server.py"
      ]
    }
   

🔍 故障排除

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

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

2. 常见问题：

   • "IDADIR not found": 按照前提条件中的说明设置环境变量
   • Connection refused: 确保没有其他 MCP 服务器实例正在运行
   • 仅限 Windows: 本项目已在 Windows 系统上测试并支持
   • 仅限 Cursor: 本项目仅在 Cursor 内部进行了测试，但应该可以与其他软件一起使用。

📝 注意事项

• 该服务器使用 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 文档和实用工具