Binary Ninja Cline MCP Server

Instructions

Implementation Reference

• binaryninja-mcp-bridge.js:140-149 (handler)

  MCP CallToolRequest handler case for list_functions tool: parses input arguments using FilePathSchema and calls the Binary Ninja HTTP server.
  case "list_functions": { try { const args = FilePathSchema.parse(request.params.arguments); result = await callBinaryNinjaServer("list_functions", args); } catch (error) { console.error(`[ERROR] Failed to parse arguments for list_functions: ${error.message}`); console.error(`[ERROR] Arguments received: ${JSON.stringify(request.params.arguments)}`); throw error; } break;
• binaryninja-mcp-bridge.js:89-92 (registration)

  Tool registration entry in ListTools response: defines name, description, and inputSchema for list_functions.
  name: "list_functions", description: "List functions in a binary", inputSchema: zodToJsonSchema(FilePathSchema), },
• binaryninja-mcp-bridge.js:19-21 (schema)

  Zod schema defining the input parameters for list_functions tool: requires a non-empty 'path' string.
  const FilePathSchema = z.object({ path: z.string().min(1, "File path cannot be empty") });
• binaryninja_http_server.py:44-52 (handler)

  Intermediate HTTP server handler for list_functions method: extracts path param, calls BinaryNinjaHTTPClient.list_functions, extracts and returns function names.
  elif method == "list_functions": path = params.get("path") if not path: return {"error": "Path parameter is required"} functions = client.list_functions(path) func_names = [f["name"] for f in functions] return {"result": func_names}
• binaryninja_http_client.py:109-137 (handler)

  Core implementation: paginates requests to Binary Ninja HTTP API /functions endpoint (offset/limit) to retrieve all functions from the loaded binary.
  def list_functions(self, file_path=None): """List all functions in the currently open binary file.""" try: # Get all functions with pagination all_functions = [] offset = 0 limit = 100 while True: response = self._request('GET', 'functions', params={"offset": offset, "limit": limit}) functions = response.get("functions", []) if not functions: break all_functions.extend(functions) # If we got fewer functions than the limit, we've reached the end if len(functions) < limit: break # Move to the next page offset += limit logger.info(f"Retrieved {len(all_functions)} functions in total") return all_functions except Exception as e: logger.error(f"Failed to list functions: {e}") raise