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. 光标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，
  这将有助于开发插件和脚本！

对于任何问题，请随时通过sysc4lls@gmai.com联系我

📄 许可证

MIT许可证

版权所有 (c) 2024 IDA Pro MCP 文档和工具