IDA Doc Hint Mcp

🚀 IDA Pro MCP 文档和工具

本项目为借助 MCP（机器码处理器）与 IDA Pro 进行交互，提供了相关文档以及实用工具。此项目源于个人学习使用 MCP 的兴趣，并非用于实际应用。

🚀 快速开始

本项目为通过 MCP 与 IDA Pro 交互提供便利，不过在使用前，需要完成一些系统要求和先决条件的设置。

⚠️ 系统要求

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

🔧 先决条件

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

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

2. Python 环境
   • 请确保已安装 Python 3.8 或更高版本。

📦 安装指南

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": "/python.exe",
   "args": [
   "/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 文档和工具