IDA Pro MCP Documentation and Utilities

IDA Pro MCP 文档与工具

本项目提供通过 MCP（Machine Code Processor）使用 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”：按前置条件中的说明设置环境变量
   • 连接被拒绝：确保没有其他 MCP 服务实例正在运行
   • 仅限 Windows：本项目仅在 Windows 系统上经过测试并受支持
   • 仅限 Cursor：本项目仅在 Cursor 中经过测试，但应该也能与其他软件配合使用。

📝 注意事项

• 服务使用 idalib，无需打开 IDA Pro！（仅 IDA 9.0 及更高版本支持此功能）
• 启动 MCP 服务前，请务必确保 IDA Pro 已正确关闭
• 运行任何 IDA Pro 自动化脚本都需要先启动 MCP 服务
• 目前本项目仅支持 Windows；不支持其他操作系统，但稍作调整后应该也能运行
• 这是个粗糙又糟糕的实现，不过在我的测试中可以正常工作。它能让大模型更好地理解其可访问的 ida-pro API， 从而帮助开发 IDA 插件和脚本！

如有任何问题，欢迎通过 [email protected] 联系我

📄 许可证

MIT 许可证

版权所有 (c) 2024 IDA Pro MCP Documentation and Utilities