IDA Pro MCP Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/taida957789-ida-mcp-server-plugin-badge.png)](https://mseep.ai/app/taida957789-ida-mcp-server-plugin)
2 
3# IDA Pro MCP Server
4 
5IDA Pro MCP Server is a plugin that allows remote querying and control of IDA Pro through the Model Context Protocol (MCP) interface. This plugin enables AI assistants (such as Claude) to interact directly with IDA Pro for binary analysis tasks.
6 
7## Overview
8 
9This server provides a series of tools that allow AI assistants to perform the following operations:
10- Get byte data from specific addresses
11- Get disassembly code
12- Get decompiled pseudocode
13- Query function names
14- Get segment information
15- List all functions
16- Find cross-references
17- Get import/export tables
18- Get entry points
19- Define/undefine functions
20- Get various data types (dword, word, byte, qword, float, double, string)
21- Get all strings in the binary file
22- Get the length of the instruction at the specified address
23 
24## Installation
25 
26> **Note:** This plugin is designed for and tested with IDA Pro version 9.0+.
27 
281. Ensure Python and related dependencies are installed:
29 
30```bash
31pip install -r requirements.txt
32```
33 
342. Copy the `ida-mcp-server.py` file to the IDA Pro plugins directory:
35   - Windows: `%Programfiles%\IDA Pro 9.0\plugins\`
36   - Linux: `~/.idapro/plugins/`
37   - macOS: `~/Library/Application Support/IDA Pro/plugins/`
38 
39## Configure Claude / VSCode
40 
41Add the following configuration to the `mcp.json` file in Claude or VSCode:
42 
43```json
44{
45  "mcpServers": {
46    "IDAPro": {
47      "url": "http://127.0.0.1:3000/sse",
48      "type": "sse"
49    }
50  }
51}
52```
53 
54## Usage
55 
561. Open a binary file in IDA Pro
572. The plugin will automatically load and start the MCP server locally (port 3000)
583. Connect your AI assistant (e.g., Claude) to this server
594. Use the AI assistant to perform binary analysis tasks
60 
61## Available Analysis Tools
62 
63IDA Pro MCP Server provides the following tools:
64 
65- `get_bytes`: Get bytes at a specified address
66- `get_disasm`: Get disassembly at a specified address
67- `get_decompiled_func`: Get pseudocode of the function containing the specified address
68- `get_function_name`: Get function name at a specified address
69- `get_segments`: Get all segment information
70- `get_functions`: Get all functions in the binary
71- `get_xrefs_to`: Get all cross-references to a specified address
72- `get_imports`: Get all imported functions
73- `get_exports`: Get all exported functions
74- `get_entry_point`: Get the entry point of the binary
75- `make_function`: Create a function at a specified address
76- `undefine_function`: Undefine a function at a specified address
77- `get_dword_at`: Get the dword at a specified address
78- `get_word_at`: Get the word at a specified address
79- `get_byte_at`: Get the byte at a specified address
80- `get_qword_at`: Get the qword at a specified address
81- `get_float_at`: Get the float at a specified address
82- `get_double_at`: Get the double at a specified address
83- `get_string_at`: Get the string at a specified address
84- `get_string_list`: Get all strings in the binary
85- `get_strings`: Get all strings in the binary (with addresses)
86 
87## Best Practices
88 
89When analyzing binary files, it's recommended to follow these steps:
90 
911. Examine the entry point
922. Analyze the import table
933. Review strings
944. Track key API calls
955. Identify main functional blocks
966. Analyze control flow
977. Identify malicious behaviors
988. Analyze algorithms and encryption routines
999. Document analysis results
10010. Use advanced techniques
101 
102## License
103 
104MIT License
105 
106Copyright (c) 2023 
107 
108Permission is hereby granted, free of charge, to any person obtaining a copy
109of this software and associated documentation files (the "Software"), to deal
110in the Software without restriction, including without limitation the rights
111to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
112copies of the Software, and to permit persons to whom the Software is
113furnished to do so, subject to the following conditions:
114 
115The above copyright notice and this permission notice shall be included in all
116copies or substantial portions of the Software.
117 
118THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
119IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
120FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
121AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
122LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
123OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
124SOFTWARE.
125